chiark / gitweb /
Disobedience notices when tracks are adopted now.
[disorder] / README.raw
... / ...
CommitLineData
1* DisOrder Raw Format Players
2
3** Purpose
4
5The purpose of raw format players is:
6
7 * Support pausing of playing tracks, with the audio device closed when not
8 in active use.
9
10 * Eliminate the inter-track gap.
11
12 * Perhaps in the future support network play.
13
14** Usage
15
16To use raw format, use the execraw module and make the command choose the
17"disorder" libao driver. You may need to link the driver from wherever
18DisOrder installs it (e.g. /usr/local/lib/ao/plugins-2) to where libao will
19look for it (e.g. /usr/lib/ao/plugins-2 or /sw/lib/ao/plugins-2).
20
21You should pass the "fragile" option to ogg123. This is because ogg123 ignores
22write errors!
23
24mpg321 does not appear to have this bug.
25
26For _non_ raw players it is advisable to use the new --wait-for-device option.
27This repeatedly tries to open the audio device before starting the player
28proper. It times out after a couple of seconds.
29
30See disorder_config(5) and the example configuration file for further
31information and examples.
32
33** Low-Level Details
34
35Raw format players are started slightly differently to normal ones. Before
36they are executed a pipe is created and one end passed to a special speaker
37process, which is spawned by the main server at startup. The file descriptor
38of the player's end is identified by $DISORDER_RAW_FD.
39
40The expected data format is a ao_sample_format structure followed by the raw
41sample data. However, this may be changed without notice in future versions of
42DisOrder. If you need a stable interface here for some reason then get in
43touch.
44
45Raw format players may be started before the track is to be played, and (if the
46track is then removed from the queue before it reaches the head) terminated
47before the track ever reaches a physical speaker. The point of this is to
48allow audio data to be ready to play the moment the previous track end, without
49having to wait for the player to start up. There is no way for a player to
50tell that this is going on.
51
52Local Variables:
53mode:outline
54fill-column:79
55End: