2 .\" Copyright (C) 2007-2009, 2013 Richard Kettlewell
4 .\" This program is free software: you can redistribute it and/or modify
5 .\" it under the terms of the GNU General Public License as published by
6 .\" the Free Software Foundation, either version 3 of the License, or
7 .\" (at your option) any later version.
9 .\" This program is distributed in the hope that it will be useful,
10 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
11 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 .\" GNU General Public License for more details.
14 .\" You should have received a copy of the GNU General Public License
15 .\" along with this program. If not, see <http://www.gnu.org/licenses/>.
17 .TH disorder-playrtp 1
19 disorder-playrtp \- play DisOrder network broadcasts
27 \fBdisorder\-playrtp\fR plays a network broadcast sent from the specified
30 If neither an address nor port are specified then the local DisOrder
31 configuration is consulted to find the server and the server is asked where the
34 If just a port is specified then the RTP stream is assumed to be unicast or
35 broadcast to that port.
37 If an address and a port are specified then the RTP stream is assumed to be
38 multicast to that group address and port.
46 will request a dedicated unicast stream from the server. The
48 may be followed by an optional port, or address/port pair, which will be the
49 local address/port to bind to and announce to the server.
52 .B \-\-api\fR, -\fB-A\fR \fIAPI\fR
53 Select the playback API.
54 The possibilities are, depending on platform and compilation options:
72 Pipe audio to a command.
75 The default is the first of the possibilities above that is supported.
77 .B \-\-device \fIDEVICE\fR, \fB\-D \fIDEVICE\fR
78 Specifies the audio device to use.
81 below for more information.
83 .B \-\-command \fICOMMAND\fR, \fB-e \fICOMMAND\fR
84 Instead of sending to a physical audio device, invoke \fICOMMAND\fR using the
85 shell and write audio samples to its standard input.
86 Currently the input will be 44100KHz 16-bit signed stereo samples.
87 If \fICOMMAND\fR exits it is re-executed; any samples that had been written to
88 the pipe but not processed by the previous instance will be lost.
91 is redundant with this option, but you might want to set
95 .B "-e \(aqcat > dump\(aq"
96 would log audio data to a file for later processing.
97 You could convert it to another format with, for instance:
99 .B "sox -c2 -traw -r44100 -s -w dump dump.wav"
101 .B \-\-pause\-mode \fIMODE\fR, \fB-P \fIMODE
102 Set the pause mode for \fB\-\-command\fR to either \fBsilence\fR (the default), in
103 which pauses are represented by sending silent samples, or \fBsuspend\fR, in which
104 writes to the subprocess are suspended, requiring it to infer a pause from flow
107 .B \-\-config \fIPATH\fR, \fB\-C \fIPATH
108 Set the configuration file.
110 .IR pkgconfdir/config .
112 .B \-\-socket \fIPATH\fR, \fB\-s \fIPATH
113 Set the control socket.
114 Normally this would not be used manually.
116 .B \-\-help\fR, \fB\-h
117 Display a usage message.
119 .B \-\-version\fR, \fB\-V
120 Display version number.
121 .SS "Buffer Control Options"
122 You shouldn't need to use these options.
123 Their effects are subject to change between version without warning.
124 You should consult the source code for details of their effects.
126 .B \-\-min \fIFRAMES\fR, \fB\-m \fIFRAMES\fR
127 Specifies the buffer low watermark in frames.
128 This also acts as the target buffer occupancy.
129 The default is taken from the
131 configuration parameter.
133 .B \-\-max \fIFRAMES\fR, \fB\-x \fIFRAMES\fR
134 Specifies the maximum buffer size in frames.
135 If there are this many frames in the buffer then reading from the
136 network socket will be suspended.
137 The default is twice the \fB\-\-min\fR value.
138 The default is taken from the
140 configuration parameter.
142 .B \-\-rcvbuf \fIBYTES\fR, \fB\-R \fIBYTES\fR
143 Specifies socket receive buffer size.
144 The default is not to change the buffer size, i.e. you get whatever the
145 local operating system chooses.
146 The buffer size will not be reduced below the operating system's default.
147 The default is taken from the
149 configuration parameter.
151 .B \-\-monitor\fR, \fB\-M
152 Periodically report how close to the buffer low watermark the buffer is.
153 If you have trouble with poor playback quality, enable this option to see if
154 the buffer is emptying out (or overfilling, though there are measures to
155 prevent that from happening).
156 .SS "Deprecated Options"
157 These options may be removed in a future version.
158 Use \fB\-\-api\fR instead.
160 .B \-\-alsa\fR, \fB\-a
161 Use ALSA to play sound.
162 Only available on Linux.
164 .B \-\-oss\fR, \fB\-o
165 Use OSS to play sound.
166 Only available on Linux and FreeBSD.
168 .B \-\-core\-audio\fR, \fB\-c
169 Use Core Audio to play sound.
170 Only available on Macs.
174 option is used by Disobedience to control a background
177 The socket will be created as a UNIX domain stream socket.
178 When a connection is received a single line is read from it.
179 The following commands are known:
187 Causes the string "running" to be sent back.
190 Print the left and right volume levels,
191 as two decimal integers between 0 and 100,
192 separated by a space.
194 .BI "setvol " left " " right
195 Set the left and right volume levels to the given decimal values,
196 which should be between 0 and 100;
197 echo back the new values as for
201 Other commands are ignored.
202 After the first command the connection is closed.
203 Only one connection at a time will be serviced.
205 This protocol is not guaranteed to be stable.
208 On a Mac, the device name can either be the human-readable name of the desired
210 To get a list of the human-readable names, visit System Preferences -> Sound;
211 the Type column has the name you want.
213 For example, you might use "Built-in Output" for the built-in speaker
214 or "Built-in Line Output" if you have connected external speakers.
215 Remember to quote the name.
217 .BR disobedience (1),
218 .BR disorder_config (5),