chiark / gitweb /
typo
[disorder] / README.streams
1 * Introduction
2
3 This file describes DisOrder's relationship to several different things that
4 get called 'streams'.
5
6 * RTP Streaming
7
8 DisOrder is capable to transmitting RTP streams over a suitable network.
9
10 ** Server Setup
11
12 To enable this make sure that all players use the speaker process, i.e. execraw
13 rather than exec (or it won't work properly) and configure the network speaker
14 backend:
15
16     api network
17     broadcast 172.17.207.255 9003
18     broadcast_from 172.17.207.2 9002
19
20 The destination address (broadcast) can be:
21    - a broadcast address for a local network
22    - a multicast address
23
24 The source address (broadcast_from) is optional but may be convenient in some
25 cases.
26
27 If the destination is a multicast address then you should set the TTL, for
28 instance:
29
30    multicast_ttl 10
31
32 (The destination can also be a unicast address but that's not a tested
33 configuration.)
34
35 ** Playing The Stream
36
37 To play, use the disorder-playrtp client.  If the destination address was a
38 unicast or broadcast address then:
39
40    disorder-playrtp 9003
41
42 If the destination address was a multicast address then you must specify that,
43 for instance:
44
45    disorder-playrtp 224.2.3.4 9003
46
47 If the client machine has a DisOrder configuration file allowing disorder(1) to
48 connect to the server then the parameters are unnecessary: disorder-playrtp
49 will figure out the details automatically.
50
51 ** Disobedience
52
53 Disobedience is capable of running disorder-playrtp in the background (provided
54 it is installed); look for the speaker icon.  If it detects that the server is
55 using network play then its volume control will apply to the local volume, not
56 the server's volume.
57
58 If you run into trouble look for *.log files in the ~/.disorder directory.
59
60 ** Limitations
61
62 Currently only 16-bit 44100Hz stereo is supported, which requires about
63 1.4Mbit/s.  At the time of writing I've found this to work fine on 100Mbit/s
64 ethernet and had reports of success with 10Mbit/s ethernet, but have not had
65 any success with wireless.
66
67 Possibly other lower-quality but lower-bandwidth encodings will be supported in
68 future.
69
70 If you have a very recent version of sox you may need to set the sox_generation
71 option.  See disorder_config(5).
72
73
74 * Icecast Streaming
75
76 This can be achieved using the speaker_command option and Icecast (see
77 http://www.icecast.org/).  It will only work if you use the speaker process,
78 i.e. execraw for everything.
79
80 I used:
81
82   speaker_command "ices2 /etc/disorder/ices.xml"
83
84 where ices.xml is:
85
86   <?xml version="1.0"?>
87   <ices>
88       <background>0</background>
89       <logpath>/var/log/ices</logpath>
90       <logfile>disorder.log</logfile>
91       <loglevel>4</loglevel>
92       <consolelog>0</consolelog>
93       <stream>
94           <metadata>
95               <name>lyonesse</name>
96               <genre>Various</genre>
97               <description>lyonesse disorder output</description>
98           </metadata>
99           <input>
100               <module>stdinpcm</module>
101               <param name="rate">44100</param>
102               <param name="channels">2</param>
103               <param name="metadata">1</param>
104               <param name="metadatafilename">/var/disorder/icedata</param>
105           </input>
106           <instance>
107               <hostname>lyonesse.anjou.terraraq.org.uk</hostname>
108               <port>8000</port>
109               <password>SOURCE PASSWORD HERE</password>
110               <mount>/disorder.ogg</mount>
111               <reconnectdelay>2</reconnectdelay>
112               <reconnectattempts>5</reconnectattempts>
113               <maxqueuelength>80</maxqueuelength>
114               <encode>
115                   <nominal-bitrate>64000</nominal-bitrate>
116                   <samplerate>44100</samplerate>
117                   <channels>2</channels>
118                   <flush-samples>8820</flush-samples>
119               </encode>
120           </instance>
121       </stream>
122   </ices>
123
124 This doesn't seem to get on very well with pausing but you're unlikely to want
125 to pause a stream in any case.  I used IceCast 2.3.1 and Ices 2.0.1.  You can
126 play the stream with XMMS or whatever.  The total setup seems to play rather
127 behind the 'current' time, watch this space for a fix (or contribute one!)
128
129 If you have a too-recent version of sox you may need to set the sox_generation
130 option.
131
132 Mark Wooding contributed the original support for this but it's been modified
133 enough that he probably shouldn't be blamed for any bugs in the current code.
134
135
136 * DisOrder and Republishing Internet Streams
137
138 DisOrder doesn't have any built-in support for playing streams but you can make
139 it do so.  I use the following in my configuration file:
140
141  player /export/radio/*.oggradio shell 'xargs ogg123 -q < "$TRACK"'
142  collection fs iso-8859-1 /export/radio
143
144 After setting this up you'll need to re-read the config file and provoke a
145 rescan:
146
147   disorder reconfigure rescan /export/radio
148
149 /export/radio contains a file for each stream, containing the URL to use:
150
151  lyonesse$ cat /export/radio/CUR1350.oggradio
152  http://cur.chu.cam.ac.uk:8000/cur.ogg
153
154 You'll probably want to prevent random play of streams:
155
156  disorder set /export/radio/CUR1350.oggradio pick_at_random 0
157
158 You can then queue a stream like any other track.  It won't automatically
159 interrupt the playing track, you have to scratch it manually.  Go back to
160 normal play by scratching the stream.
161
162
163 Local Variables:
164 mode:outline
165 fill-column:79
166 End: