NAME disorder-playrtp - play DisOrder network broadcasts SYNOPSIS disorder-playrtp [OPTIONS] [--] [[ADDRESS] PORT] DESCRIPTION disorder-playrtp plays a network broadcast sent from the specified address. If neither an address nor port are specified then the local DisOrder configuration is consulted to find the server and the server is asked where the RTP stream is. If just a port is specified then the RTP stream is assumed to be uni- cast or broadcast to that port. If an address and a port are specified then the RTP stream is assumed to be multicast to that group address and port. OPTIONS The default sound API is the first of the ones listed below that are available. Usually this implies ALSA under Linux and Core Audio under OS X. --alsa, -a Use ALSA to play sound. Only available on Linux. --oss, -o Use OSS to play sound. Only available on Linux and FreeBSD. --core-audio, -c Use Core Audio to play sound. Only available on Macs. --device DEVICE, -D DEVICE Specifies the audio device to use. See DEVICE NAMES below for more information. --command COMMAND, -e COMMAND Instead of sending to a physical audio device, invoke COMMAND using the shell and write audio samples to its standard input. Currently the input will be 44100KHz 16-bit signed stereo sam- ples. If COMMAND exits it is re-executed; any samples that had been written to the pipe but not processed by the previous instance will be lost. --device is redundant with this option, but you might want to set --pause-mode. As an example, -e 'cat > dump' would log audio data to a file for later processing. You could convert it to another format with, for instance: sox -c2 -traw -r44100 -s -w dump dump.wav --pause-mode MODE, -P MODE Set the pause mode for --command to either silence (the default), in which pauses are represented by sending silent sam- ples, or suspend, in which writes to the subprocess are sus- pended, requiring it to infer a pause from flow control. --config PATH, -C PATH Set the configuration file. The default is /etc/disorder/con- fig. --socket PATH, -s PATH Set the control socket. Normally this would not be used manu- ally. --help, -h Display a usage message. --version, -V Display version number. Buffer Control Options You shouldn't need to use these options. Their effects are subject to change between version without warning. You should consult the source code for details of their effects. --min FRAMES, -m FRAMES Specifies the buffer low watermark in frames. This also acts as the target buffer occupancy. --max FRAMES, -x FRAMES Specifies the maximum buffer size in frames. If there are this many frames in the buffer then reading from the network socket will be suspended. The default is twice the --min value. --rcvbuf BYTES, -R BYTES Specifies socket receive buffer size. The default is not to change the buffer size, i.e. you get whatever the local operat- ing system chooses. The buffer size will not be reduced below the operating system's default. --monitor, -M Periodically report how close to the buffer low watermark the buffer is. If you have trouble with poor playback quality, enable this option to see if the buffer is emptying out (or overfilling, though there are measures to prevent that from hap- pening). REMOTE CONTROL The --socket option is used by Disobedience to control a background disorder-playrtp daemon. The socket will be created as a UNIX domain stream socket. When a connection is received a single line is read from it. The following commands are known: stop Causes disorder-playrtp to terminate. query Causes the string "running" to be sent back. Other commands are ignored. After the first command the connection is closed. Only one connection at a time will be serviced. This protocol is not guaranteed to be stable. DEVICE NAMES Core Audio On a Mac, the device name can either be the human-readable name of the desired output or its UID. To get a list of the human-readable names, visit System Preferences -> Sound; the Type column has the name you want. For example, you might use "Built-in Output" for the built-in speaker or "Built-in Line Output" if you have connected external speakers. Remember to quote the name. SEE ALSO disobedience(1), disorder_config(5), disorderd(8)