232 lines
9.3 KiB
Groff
232 lines
9.3 KiB
Groff
.TH mpd.conf 5
|
|
.SH NAME
|
|
mpd.conf \- Music Player Daemon configuration file
|
|
.SH DESCRIPTION
|
|
\fBmpd.conf\fP is the configuration file for mpd(1). If not specified on the
|
|
command line, MPD first searches for it at \fB$XDG_CONFIG_HOME/mpd/mpd.conf\fP
|
|
then at \fB~/.mpdconf\fP then at \fB~/.mpd/mpd.conf\fP and then in
|
|
\fB/etc/mpd.conf\fP.
|
|
|
|
Lines beginning with a "#" character are comments. All other non-empty lines
|
|
specify parameters and their values. These lines contain the parameter name
|
|
and parameter value (surrounded by double quotes) separated by whitespace
|
|
(either tabs or spaces). For example:
|
|
|
|
parameter "value"
|
|
|
|
The exceptions to this rule are the parameters for input plugins, decoders, databases, and
|
|
audio_output, which are of the form:
|
|
|
|
audio_output {
|
|
.br
|
|
parameter1 "value"
|
|
parameter2 "value"
|
|
.br
|
|
}
|
|
|
|
Input and decoder plugins always have the parameter \fIenabled\fP, which accepts the
|
|
possible values "yes" or "no", and the parameter \fIplugin\fP, which gives the name of
|
|
the plugin. Each such plugin has its own documentation in the online user manual, listing
|
|
additional parameters that can affect the behavior of the decoder.
|
|
|
|
Parameters that take a file or directory as an argument should use absolute
|
|
paths.
|
|
|
|
See \fB/etc/mpd/mpdconf.example\fP for an example configuration file.
|
|
|
|
This manual is not complete, it lists only the most important options.
|
|
Please read the MPD user manual for a complete configuration guide:
|
|
<\fBhttp://www.musicpd.org/doc/user/\fP>
|
|
.SH REQUIRED PARAMETERS
|
|
.TP
|
|
.B db_file <file>
|
|
This specifies where the db file will be stored.
|
|
.TP
|
|
.B log_file <file>
|
|
This specifies where the log file should be located.
|
|
The special value "syslog" makes MPD use the local syslog daemon.
|
|
.SH OPTIONAL PARAMETERS
|
|
.TP
|
|
.B sticker_file <file>
|
|
The location of the sticker database. This is a database which
|
|
manages dynamic information attached to songs.
|
|
.TP
|
|
.B pid_file <file>
|
|
This specifies the file to save mpd's process ID in.
|
|
.TP
|
|
.B music_directory <directory>
|
|
This specifies the directory where music is located.
|
|
If you do not configure this, you can only play streams.
|
|
.TP
|
|
.B playlist_directory <directory>
|
|
This specifies the directory where saved playlists are stored.
|
|
If you do not configure this, you cannot save playlists.
|
|
.TP
|
|
.B state_file <file>
|
|
This specifies if a state file is used and where it is located. The state of
|
|
mpd will be saved to this file when mpd is terminated by a TERM signal or by
|
|
the "kill" command. When mpd is restarted, it will read the state file and
|
|
restore the state of mpd (including the playlist).
|
|
.TP
|
|
.B restore_paused <yes or no>
|
|
Put MPD into pause mode instead of starting playback after startup.
|
|
.TP
|
|
.B user <username>
|
|
This specifies the user that MPD will run as, if set. MPD should
|
|
never run as root, and you may use this option to make MPD change its
|
|
user id after initialization. Do not use this option if you start MPD
|
|
as an unprivileged user.
|
|
.TP
|
|
.B port <port>
|
|
This specifies the port that mpd listens on. The default is 6600.
|
|
.TP
|
|
.B log_level <default, secure, or verbose>
|
|
This specifies how verbose logs are. "default" is minimal logging, "secure"
|
|
reports from what address a connection is opened, and when it is closed, and
|
|
"verbose" records excessive amounts of information for debugging purposes. The
|
|
default is "default".
|
|
.TP
|
|
.B follow_outside_symlinks <yes or no>
|
|
Control if MPD will follow symbolic links pointing outside the music dir.
|
|
You must recreate the database after changing this option.
|
|
The default is "yes".
|
|
.TP
|
|
.B follow_inside_symlinks <yes or no>
|
|
Control if MPD will follow symbolic links pointing inside the music dir,
|
|
potentially adding duplicates to the database.
|
|
You must recreate the database after changing this option.
|
|
The default is "yes".
|
|
.TP
|
|
.B zeroconf_enabled <yes or no>
|
|
If yes, and MPD has been compiled with support for Avahi or Bonjour, service
|
|
information will be published with Zeroconf. The default is yes.
|
|
.TP
|
|
.B zeroconf_name <name>
|
|
If Zeroconf is enabled, this is the service name to publish. This name should
|
|
be unique to your local network, but name collisions will be properly dealt
|
|
with. The default is "Music Player @ %h", where %h will be replaced with the
|
|
hostname of the machine running MPD.
|
|
.TP
|
|
.B audio_output
|
|
See \fBDESCRIPTION\fP and the various \fBAUDIO OUTPUT PARAMETERS\fP sections
|
|
for the format of this parameter. Multiple audio_output sections may be
|
|
specified. If no audio_output section is specified, then MPD will scan for a
|
|
usable audio output.
|
|
.TP
|
|
.B replaygain <off or album or track or auto>
|
|
If specified, mpd will adjust the volume of songs played using ReplayGain tags
|
|
(see <\fBhttp://www.replaygain.org/\fP>). Setting this to "album" will adjust
|
|
volume using the album's ReplayGain tags, while setting it to "track" will
|
|
adjust it using the track ReplayGain tags. "auto" uses the track ReplayGain
|
|
tags if random play is activated otherwise the album ReplayGain tags. Currently
|
|
only FLAC, Ogg Vorbis, Musepack, and MP3 (through ID3v2 ReplayGain tags, not
|
|
APEv2) are supported.
|
|
.TP
|
|
.B replaygain_preamp <\-15 to 15>
|
|
This is the gain (in dB) applied to songs with ReplayGain tags.
|
|
.TP
|
|
.B volume_normalization <yes or no>
|
|
If yes, mpd will normalize the volume of songs as they play. The default is no.
|
|
.TP
|
|
.B filesystem_charset <charset>
|
|
This specifies the character set used for the filesystem. A list of supported
|
|
character sets can be obtained by running "iconv \-l". The default is
|
|
determined from the locale when the db was originally created.
|
|
.TP
|
|
.B save_absolute_paths_in_playlists <yes or no>
|
|
This specifies whether relative or absolute paths for song filenames are used
|
|
when saving playlists. The default is "no".
|
|
.TP
|
|
.B auto_update <yes or no>
|
|
This specifies the whether to support automatic update of music database when
|
|
files are changed in music_directory. The default is to disable autoupdate
|
|
of database.
|
|
.TP
|
|
.B auto_update_depth <N>
|
|
Limit the depth of the directories being watched, 0 means only watch
|
|
the music directory itself. There is no limit by default.
|
|
.TP
|
|
.SH REQUIRED AUDIO OUTPUT PARAMETERS
|
|
.TP
|
|
.B type <type>
|
|
This specifies the audio output type. See the list of supported outputs in mpd
|
|
\-\-version for possible values.
|
|
.TP
|
|
.B name <name>
|
|
This specifies a unique name for the audio output.
|
|
.SH OPTIONAL AUDIO OUTPUT PARAMETERS
|
|
.TP
|
|
.B format <sample_rate:bits:channels>
|
|
This specifies the sample rate, bits per sample, and number of channels of
|
|
audio that is sent to the audio output device. See documentation for the
|
|
\fBaudio_output_format\fP parameter for more details. The default is to use
|
|
whatever audio format is passed to the audio output.
|
|
Any of the three attributes may be an asterisk to specify that this
|
|
attribute should not be enforced
|
|
.TP
|
|
.B replay_gain_handler <software, mixer or none>
|
|
Specifies how replay gain is applied. The default is "software",
|
|
which uses an internal software volume control. "mixer" uses the
|
|
configured (hardware) mixer control. "none" disables replay gain on
|
|
this audio output.
|
|
.SH OPTIONAL ALSA OUTPUT PARAMETERS
|
|
.TP
|
|
.B device <dev>
|
|
This specifies the device to use for audio output. The default is "default".
|
|
.TP
|
|
.B mixer_type <hardware, software or none>
|
|
Specifies which mixer should be used for this audio output: the
|
|
hardware mixer (available for ALSA, OSS and PulseAudio), the software
|
|
mixer or no mixer ("none"). By default, the hardware mixer is used
|
|
for devices which support it, and none for the others.
|
|
.TP
|
|
.B mixer_device <mixer dev>
|
|
This specifies which mixer to use. The default is "default". To use
|
|
the second sound card in a system, use "hw:1".
|
|
.TP
|
|
.B mixer_control <mixer ctrl>
|
|
This specifies which mixer control to use (sometimes referred to as
|
|
the "device"). The default is "PCM". Use "amixer scontrols" to see
|
|
the list of possible controls.
|
|
.TP
|
|
.B mixer_index <mixer index>
|
|
A number identifying the index of the named mixer control. This is
|
|
probably only useful if your alsa device has more than one
|
|
identically\-named mixer control. The default is "0". Use "amixer
|
|
scontrols" to see the list of controls with their indexes.
|
|
.TP
|
|
.B auto_resample <yes or no>
|
|
Setting this to "no" disables ALSA's software resampling, if the
|
|
hardware does not support a specific sample rate. This lets MPD do
|
|
the resampling. "yes" is the default and allows ALSA to resample.
|
|
.TP
|
|
.B auto_channels <yes or no>
|
|
Setting this to "no" disables ALSA's channel conversion, if the
|
|
hardware does not support a specific number of channels. Default: "yes".
|
|
.TP
|
|
.B auto_format <yes or no>
|
|
Setting this to "no" disables ALSA's sample format conversion, if the
|
|
hardware does not support a specific sample format. Default: "yes".
|
|
.TP
|
|
.B buffer_time <time in microseconds>
|
|
This sets the length of the hardware sample buffer in microseconds. Increasing
|
|
it may help to reduce or eliminate skipping on certain setups. Most users do
|
|
not need to change this. The default is 500000 microseconds (0.5 seconds).
|
|
.TP
|
|
.B period_time <time in microseconds>
|
|
This sets the time between hardware sample transfers in microseconds.
|
|
Increasing this can reduce CPU usage while lowering it can reduce underrun
|
|
errors on bandwidth-limited devices. Some users have reported good results
|
|
with this set to 50000, but not all devices support values this high. Most
|
|
users do not need to change this. The default is 256000000 / sample_rate(kHz),
|
|
or 5804 microseconds for CD-quality audio.
|
|
.SH FILES
|
|
.TP
|
|
.BI ~/.mpdconf
|
|
User configuration file.
|
|
.TP
|
|
.BI /etc/mpd.conf
|
|
Global configuration file.
|
|
.SH SEE ALSO
|
|
mpd(1), mpc(1)
|