moosicast.conf — configuration file for the moosicast music server and client
moosicast.conf is the main configuration file for the moosicastd audio
server and the moosicast control program.
The syntax of the moosicast.conf configuration file is simple. The
file contains a number of variable definitions expressed as name/value
pairs separated by an equals sign. All values are strings delimited
either by double quotes or curly braces, depending on whether or not they
contain embedded newline characters. For example:
variable1 = "this is the value of variable1"
variable2 = {
this is the value
of variable2
}
Note that the value of variable2 will contain a single newline character.
Both inside and outside value delimeters, newline characters immediately preceeded by backslashes are ignored (as are the backslashes). For instance, the following declarations are equivalent:
myvar = "a b c"
myvar = {
a \
b \
c
}
The following variables affect the behavior of moosicast:
datadir (required)The directory where moosicast should store runtime data.
moosicd_config (required)The moosicd(1) configuration specified as an extended string. Note that this configuration is modified by moosicastd prior to launching moosicd.
outputs (optional)A list of output commands to run, specified one-per-line (backslash line continuations may be used to extend a command over several lines). If left unspecified, no output commands are executed (this is probably not very useful).
preexec_extras (optional)A list of commands to run just prior to execution of moosicd, specified one-per-line (backslash line continuatinos may be used to extend a command over several lines). This list may include commands that prepare the audio files for playing (by mounting network fileshares, for example).
postexec_extras (optional)A list of commands to run immediately following execution of moosicd, specified one-per-line (backslash line continuations may be used to extend a command over several lines). Typically, a moosic client might be included in this list.
pidfile (optional)The name of the file to store the moosicd process ID in. If left unspecified, the PID is not stored in a file.
buffersize (optional)The buffersize used for magicpipe instances. Note that other buffering is also likely performed by the operating system, as well as library functions (like stdio's).
blocksize (optional)This is the blocksize argument to pass to magicpipe. Leaving this unspecified causes the magicpipe default to be accepted. That is probably acceptable under most circumstances.
loglevel (optional)Specifies the level of verbosity for moosicastd's error output. Should be one of "ALL", "DEBUG", "INFO", "WARNING", "ERROR", or "CRITICAL".
daemonize (optional)If True, moosicastd will deamonize; otherwise moosicastd will remain connected to the terminal.
logfile (optional)File to direct all log output to.