MPD.CONF(5) Music Player Daemon MPD.CONF(5) (NAME) mpd.conf - (Music Player Daemon) (DESCRIPTION) mpd.conf mpd(1) . /etc/mpd.conf . MPD ( ) $XDG_CONFIG_HOME/mpd/mpd.conf ( ~/.config/mpd/mpd.conf) . mpd.conf . : connection_timeout "5" # . (~) $HOME . : o $HOME o $XDG_CONFIG_HOME o $XDG_MUSIC_DIR o $XDG_CACHE_HOME o $XDG_RUNTIME_DIR : music_directory "~/Music" db_file "$XDG_CONFIG_HOME/mpd/database" (per-plugin): audio_output { type "alsa" name "My ALSA output" device "iec958:CARD=Intel,DEV=0" mixer_control "PCM" } include : include "other.conf" include_optional : include_optional "may_not_exist.conf" docs/mpdconf.example . . MPD : (GLOBAL SETTINGS) (System Settings) user NAME MPD . MPD (root) MPD (UID) . MPD . group NAME . . . pid_file PATH (PID) mpd . log_file PATH . "syslog" MPD syslog . log_level LEVEL notice . : o error: o warning: o notice: o info: o verbose: ( ) (Client Settings) port number 6600 (port) mpd . (File Settings) db_file PATH . sticker_file PATH (sticker database). . music_directory PATH . . playlist_directory PATH ( ). . state_file PATH . mpd TERM kill mpd . mpd mpd ( ) . follow_outside_symlinks yes no yes MPD (symlinks) . . follow_inside_symlinks yes no yes MPD . . auto_update yes no no music_directory . ( .) auto_update_depth number unlimited 0 . save_absolute_paths_in_playlists yes no no . filesystem_charset CHARSET (character set) . "iconv -l" . (locale) . (Player Settings) restore_paused yes no no MPD . (Other Settings) zeroconf_enabled yes no yes yes MPD Avahi Bonjour Zeroconf . zeroconf_name NAME Music Player @ %h Zeroconf . . %h MPD . audio_output DESCRIPTION AUDIO OUTPUT OPTIONS . audio_output . audio_output MPD . (REQUIRED AUDIO OUTPUT SETTINGS) type NAME . mpd --version . name NAME . (OPTIONAL AUDIO OUTPUT SETTINGS) format :: ``sample_rate:bits:channels`` . audio_output_format . . (*) . replay_gain_handler software mixer none software replay gain . software . mixer () . none replay gain . mixer_type hardware software none hardware ( ) none : ( ALSA OSS PulseAudio) (none). (FILES) $XDG_CONFIG_HOME/mpd/mpd.conf ( ~/.config/mpd/mpd.conf). /etc/mpd.conf . (SEE ALSO) mpd(1), mpc(1) (AUTHOR) Max Kellermann (COPYRIGHT) 2003-2025 The Music Player Daemon Project 0.24.15 August 28, 2026 MPD.CONF(5)