Quotation mark
.\" "
.TP
-.B \e'
+.B \e\(aq
Apostrophe
.TP
.B \en
Defaults to
.IR pkgstatedir .
The server will create this directory on startup if it does not exist.
+.IP
+This setting cannot be changed during the lifetime of the server.
.TP
.B plugins \fIPATH\fR
Adds a directory to the plugin path.
automatically included, but should include the proper extension.
.IP
The default is \fB{/artist}{/album}{/title}{ext}\fR.
+.IP
+This setting cannot be changed during the lifetime of the server.
.TP
.B api \fINAME\fR
Selects the backend used to play sound and to set the volume.
.RS
.TP 8
.B pcm
-
Output level for the audio device.
This is probably what you want and is the default.
.TP
.B cookie_key_lifetime \fISECONDS\fR
Lifetime of the signing key used in constructing cookies. The default is one
week.
+.IP
+If this is changed during the lifetime of the server, the current key doesn't
+hvave its lifetime retroactively changed.
.TP
.B cookie_login_lifetime \fISECONDS\fR
Lifetime of a cookie enforced by the server. When the cookie expires the user
will have to log in again even if their browser has remembered the cookie that
long. The default is one day.
+.IP
+If this is changed during the lifetime of the server, cookies that have already
+een generated don't hvave their lifetime retroactively changed.
.TP
.B default_rights \fIRIGHTS\fR
Defines the set of rights given to new users.
default is.
.TP
.B gap \fISECONDS\fR
-Specifies the number of seconds to leave between tracks.
-The default is 0.
-.IP
-NB this option currently DOES NOT WORK. If there is genuine demand it might be
-reinstated.
+This option no longer does anything and will be removed in a future version.
.TP
.B history \fIINTEGER\fR
Specifies the number of recently played tracks to remember (including
failed tracks and scratches).
+.IP
+If this is changed during the lifetime of the server, it won't actually reduce
+the size of the list until it is next modified.
.TP
.B listen \fR[\fIFAMILY\fR] \fR[\fIHOST\fR] \fISERVICE\fR
Listen for connections on the address specified by \fIHOST\fR and port
Normally the server only listens on a UNIX domain socket.
.TP
.B lock yes\fR|\fBno
-Determines whether the server locks against concurrent operation.
-Default is \fByes\fR.
-There is no good reason to set this to \fBno\fR and the option will
-probably be removed in a future version.
+This option no longer does anything and will be removed in a future version.
.TP
.B mixer \fIDEVICE\fR
The mixer device name, if it needs to be specified separately from
.IP
For \fBapi coreaudio\fR, volume setting is not currently supported.
.TP
+.B mount_rescan yes\fR|\fBno
+Determines whether mounts and unmounts will cause an automatic rescan.
+The default is \fByes\fR.
+.TP
.B multicast_loop yes\fR|\fBno
Determines whether multicast packets are loop backed to the sending host.
The default is \fByes\fR.
namepart artist "/([^/]+)/[^/]+/[^/]+$" $1 *
namepart ext "(\\.[a-zA-Z0-9]+)$" $1 *
.fi
+.IP
+This setting cannot be changed during the lifetime of the server.
.TP
.B new_bias \fIWEIGHT\fR
The weight for new tracks.
The default is 450000, i.e. recently added tracks are a fifty times as likely
to be picked as normal.
+.IP
+New values of this option may be picked up from the configuration file even
+without a reload.
.TP
.B new_bias_age \fISECONDS\fR
The maximum age of tracks that \fBnew_bias\fR applies to, in seconds.
The default is one week.
+.IP
+New values of this option may be picked up from the configuration file even
+without a reload.
.TP
.B new_max \fIMAX\fR
The maximum number of tracks to list when reporting newly noticed tracks.
If you have limited CPU then it might help to set this to a small
negative value.
The default is 0.
+.IP
+Changes to this value during the lifetime of the server are ignored.
.TP
.B nice_speaker \fIPRIORITY\fR
Set the speaker process priority.
If you have limited CPU then it might help to set this to a small
negative value.
The default is 0.
+.IP
+Changes to this value during the lifetime of the server are ignored.
.TP
.B noticed_history
The maximum days that a track can survive in the database of newly added
.RS
.TP
.B \-\-wait\-for\-device\fR[\fB=\fIDEVICE\fR]
+\fBThis option is deprecated\fR.
+If you want gapless play use raw-format players and the speaker process instead.
+(This the default in any case.)
+.IP
Waits (for up to a couple of seconds) for the default, or specified, libao
device to become openable.
.TP
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
.B player
is used without arguments, the list of players is cleared.
+.IP
+Although players can be changed during the lifetime of the server, note that
+background decoders will not be stopped and restarted using changed
+configuration once they have been started.
.TP
.B prefsync \fISECONDS\fR
-The interval at which the preferences log file will be synchronised.
-Defaults to 3600, i.e. one hour.
+This option no longer does anything and will be removed in a future version.
.TP
.B queue_pad \fICOUNT\fR
The target size of the queue.
If random play is enabled then randomly picked tracks will be added until
the queue is at least this big.
The default is 10.
+.IP
+If this is reduced during the lifetime of the server, the queue won't be
+reduced in size to fit; it just won't start growing again until it is under the
+new value.
+However, if it is increased, new tracks will start being added immediately.
.TP
.B reminder_interval \fISECONDS\fR
The minimum number of seconds that must elapse between password reminders.
before it can be picked at random. The default is 8 hours. If this is set to
0 then there is no limit, though current \fBdisorder-choose\fR will not pick
anything currently listed in the recently-played list.
+.IP
+New values of this option may be picked up from the configuration file even
+without a reload.
.TP
.B sample_format \fIBITS\fB/\fIRATE\fB/\fICHANNELS
Describes the sample format expected by the \fBspeaker_command\fR (below).
.IP
There is a default set of stopwords built in, but this option can be used to
augment or replace that list.
+.IP
+This setting cannot be changed during the lifetime of the server.
.TP
.B tracklength \fIPATTERN\fR \fIMODULE\fR
Specifies the module used to calculate the length of files matching
.IP
If \fBtracklength\fR is used without arguments then the list of modules is
cleared.
+.IP
+Track lengths are cached in the database, and changing this setting won't cause
+them to be regenerated.
.TP
.B user \fIUSERNAME\fR
Specifies the user to run as.
Only makes sense if invoked as root (or the target user).
+.IP
+This setting cannot be changed during the lifetime of the server
+(and if it is changed with a restart, you will need to adjust file permissions
+on the server's database).
.SS "Client Configuration"
These options would normally be used in \fI~\fRUSERNAME\fI/.disorder/passwd\fR
or
.TP
.B refresh \fISECONDS\fR
Specifies the maximum refresh period in seconds.
+The refresh period is the time after which the web interface's queue and manage
+pages will automatically reload themselves.
Default 15.
.TP
+.B refresh_min \fISECONDS\fR
+Specifies the minimum refresh period in seconds.
+Default 1.
+.TP
.B sendmail \fIPATH\fR
The path to the Sendmail executable.
This must support the \fB-bs\fR option (Postfix, Exim and Sendmail should all
.IP
This must be the full URL, e.g. \fBhttp://myhost/cgi-bin/jukebox\fR and not
\fB/cgi-bin/jukebox\fR.
-.SH "GLOBAL PREFERENCES"
-.SH "LIBAO DRIVER"
-.SS "Raw Protocol Players"
-Raw protocol players are expected to use the \fBdisorder\fR libao driver.
-Programs that use libao generally have command line options to select the
-driver and pass options to it.
-.SS "Driver Options"
-The known driver options are:
-.TP
-.B fd
-The file descriptor to write to.
-If this is not specified then the driver looks like the environment
-variable \fBDISORDER_RAW_FD\fR.
-If that is not set then the default is 1 (i.e. standard output).
-.TP
-.B fragile
-If this is set to a nonzero value then the driver will call \fB_exit\fR(2) if a
-write to the output file descriptor fails.
-This is a workaround for buggy players such as \fBogg123\fR that ignore
-write errors.
.SH "REGEXP SUBSTITUTION RULES"
Regexps are PCRE regexps, as defined in \fBpcrepattern\fR(3).
The only option used is \fBPCRE_UTF8\fR.
~mdw / disorder / blobdiff