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)