.IP
The default is \fB{/artist}{/album}{/title}{ext}\fR.
.TP
+.B authorization_algorthm \fIALGORITHM\fR
+Defines the algorithm used to authenticate clients. The valid options
+are sha1 (the default), sha256, sha384 and sha512. See
+.BR disorder_protocol (5)
+for more details.
+.TP
+.B broadcast \fIADDRESS\fR \fIPORT\fR
+Transmit sound data to \fIADDRESS\fR using UDP port \fIPORT\fR. This implies
+\fBspeaker_backend network\fR.
+.TP
+.B broadcast_from \fIADDRESS\fR \fIPORT\fR
+Sets the (local) source address used by \fBbroadcast\fR.
+.TP
.B channel \fICHANNEL\fR
The mixer channel that the volume control should use. Valid names depend on
your operating system and hardware, but some standard ones that might be useful
The path to the mixer device, if you want access to the volume control,
e.g. \fB/dev/mixer\fR.
.TP
+.B multicast_ttl \fIHOPS\fR
+Set the maximum number of hops to send multicast packets. This only applies is
+\fBspeaker_backend\fR is set to \fBnetwork\fR and \fBbroadcast\fR is actually a
+multicast address.
+.TP
.B namepart \fIPART\fR \fIREGEXP\fR \fISUBST\fR [\fICONTEXT\fR [\fIREFLAGS\fR]]
Determines how to extract trackname part \fIPART\fR from a
track name (with the collection root part removed).
Set the recan subprocess priority. The default is 10.
.IP
(Note that higher values mean the process gets less CPU time; UNIX priority
-values are the backwards.)
+values are backwards.)
.TP
.B nice_server \fIPRIORITY\fR
Set the server priority. This is applied to the server at startup time (and
timely scheduling. If you have limited CPU then it might help to set this to a
small negative value. The default is 0.
.TP
+.B noticed_history
+The maximum days that a track can survive in the database of newly added
+tracks. The default is 31.
+.TP
.B player \fIPATTERN\fR \fIMODULE\fR [\fIOPTIONS.. [\fB--\fR]] \fIARGS\fR...
Specifies the player for files matching the glob \fIPATTERN\fR. \fIMODULE\fR
specifies which plugin module to use.
.TP
.B execraw \fICOMMAND\fR \fIARGS\fR...
Identical to the \fBexec\fR except that the player is expected to use the
-DisOrder raw player protocol (see notes below).
+DisOrder raw player protocol.
+.BR disorder-decode (8)
+can decode several common audio file formats to this format. If your favourite
+format is not supported, but you have a player which uses libao, there is also
+a libao driver which supports this format; see below for more information about
+this.
.TP
.B shell \fR[\fISHELL\fR] \fICOMMAND\fR
The command is executed using the shell. If \fISHELL\fR is specified then that
Signals are specified by their full C name, i.e. \fBSIGINT\fR and not \fBINT\fR
or \fBInterrupted\fR or whatever.
.TP
+.B speaker_backend \fINAME\fR
+Selects the backend use by the speaker process. The following options are
+available:
+.RS
+.TP
+.B alsa
+Use the ALSA API. This is only available on Linux systems, on which it is the
+default.
+.TP
+.B command
+Execute a command. This is the default if
+.B speaker_command
+is specified, or (currently) on non-Linux systems.
+.TP
+.B network
+Transmit audio over the network. This is the default if
+\fBbroadcast\fR is specified. You can use
+.BR disorder-playrtp (1)
+to receive and play the resulting stream on Linux and OS X.
+.RE
+.TP
.B sox_generation \fB0\fR|\fB1
Determines whether calls to \fBsox\fR(1) should use \fB-b\fR, \fB-x\fR, etc (if
the generation is 0) or \fB-\fIbits\fR, \fB-L\fR etc (if it is 1). The default
over track names.
.SS "Client Configuration"
.TP
-.B connect \fR[\fIHOST\fR] \fISERVICE\fR
+.B connect \fIHOST SERVICE\fR
Connect to the address specified by \fIHOST\fR and port specified by
-\fISERVICE\fR. If \fIHOST\fR is omitted then connects to the local host.
-Normally the UNIX domain socket is used instead.
+\fISERVICE\fR.
.SS "Web Interface Configuration"
.TP
.B refresh \fISECONDS\fR
Provides a front end to \fBchoose.html\fR which allows subsets of the top level
directories to be selected by initial letter.
.TP
+.B new.html
+Lists newly added tracks.
+.TP
.B playing.html
The "front page", which usually shows the currently playing tracks and
the queue.
.B credits.html
Included at the end of the main content \fB<DIV>\fR element.
.TP
-.B sidebar.html
-Included at the start of the \fB<BODY>\fR element.
+.B topbar.html
+Included at the start of the \fB<BODY>\fR element. (This supplants
+\fBsidebar.html\fR, though the latter is still available; override label
+\fBmenu\fR to choose between them.)
.TP
.B stdhead.html
Included in the \fB<HEAD>\fR element.
Expands to \fBtrue\fR if this is the last repetition of a \fITEMPLATE\fR in a
loop, otherwise to \fBfalse\fR.
.TP
+.B @isnew@
+Expands to \fBtrue\fR if the newly added tracks list has any tracks in it,
+otherwise to \fBfalse\fR.
+.TP
.B @isplaying@
Expands to \fBtrue\fR if a track is playing, otherwise to \fBfalse\fR.
.TP
.B @ne{\fIA\fB}{\fIB\fB}
Expands to \fBtrue\fR if \fIA\fR and \fIB\fR differ, otherwise to \fBfalse\fR.
.TP
+.B @new{\fITEMPLATE\fB}
+Expands \fITEMPLATE\fR for each track in the newly added tracks list, starting
+with the most recent. Used in \fBnew.html\fR.
+.TP
.B @nfiles@
Expands to the number of files from \fB@files\fR (above).
.TP
~mdw / disorder / blobdiff