1 # An example configuration file for MPD.
2 # Read the user manual for documentation: http://www.musicpd.org/doc/user/
3 # or /usr/share/doc/mpd/user-manual.html
6 # Files and directories #######################################################
8 # This setting controls the top directory which MPD will search to discover the
9 # available audio files and add them to the daemon's online database. This
10 # setting defaults to the XDG directory, otherwise the music directory will be
11 # be disabled and audio files will only be accepted over ipc socket (using
12 # file:// protocol) or streaming files over an accepted protocol.
14 music_directory "~/media/"
16 # This setting sets the MPD internal playlist directory. The purpose of this
17 # directory is storage for playlists created by MPD. The server will use
18 # playlist files not created by the server but only if they are in the MPD
19 # format. This setting defaults to playlist saving being disabled.
21 playlist_directory "~/var/mpd/playlists"
23 # This setting sets the location of the MPD database. This file is used to
24 # load the database at server start up and store the database while the
25 # server is not up. This setting defaults to disabled which will allow
26 # MPD to accept files over ipc socket (using file:// protocol) or streaming
27 # files over an accepted protocol.
29 db_file "~/var/mpd/tag_cache"
31 # These settings are the locations for the daemon log files for the daemon.
32 # These logs are great for troubleshooting, depending on your log_level
35 # The special value "syslog" makes MPD use the local syslog daemon. This
36 # setting defaults to logging to syslog, otherwise logging is disabled.
38 log_file "~/var/mpd/mpd.log"
40 # This setting sets the location of the file which stores the process ID
41 # for use of mpd --kill and some init scripts. This setting is disabled by
42 # default and the pid file will not be stored.
44 pid_file "~/var/mpd/pid"
46 # This setting sets the location of the file which contains information about
47 # most variables to get MPD back into the same general shape it was in before
48 # it was brought down. This setting is disabled by default and the server
49 # state will be reset on server start up.
51 state_file "~/var/mpd/state"
53 # The location of the sticker database. This is a database which
54 # manages dynamic information attached to songs.
56 sticker_file "~/var/mpd/sticker.sql"
58 ###############################################################################
61 # General music daemon options ################################################
63 # This setting specifies the user that MPD will run as. MPD should never run as
64 # root and you may use this setting to make MPD change its user ID after
65 # initialization. This setting is disabled by default and MPD is run as the
70 # This setting specifies the group that MPD will run as. If not specified
71 # primary group of user specified with "user" setting will be used (if set).
72 # This is useful if MPD needs to be a member of group such as "audio" to
73 # have permission to use sound card.
77 # This setting sets the address for the daemon to listen on. Careful attention
78 # should be paid if this is assigned to anything other then the default, any.
79 # This setting can deny access to control of the daemon. Choose any if you want
80 # to have mpd listen on every address
83 #bind_to_address "localhost"
86 bind_to_address "~/var/mpd/socket"
88 # This setting is the TCP port that is desired for the daemon to get assigned
93 # This setting controls the type of information which is logged. Available
94 # setting arguments are "default", "secure" or "verbose". The "verbose" setting
95 # argument is recommended for troubleshooting, though can quickly stretch
96 # available resources on limited hardware storage.
100 # If you have a problem with your MP3s ending abruptly it is recommended that
101 # you set this argument to "no" to attempt to fix the problem. If this solves
102 # the problem, it is highly recommended to fix the MP3 files with vbrfix
103 # (available as vbrfix in the debian archive), at which
104 # point gapless MP3 playback can be enabled.
106 #gapless_mp3_playback "yes"
108 # Setting "restore_paused" to "yes" puts MPD into pause mode instead
109 # of starting playback after startup.
113 # This setting enables MPD to create playlists in a format usable by other
116 #save_absolute_paths_in_playlists "no"
118 # This setting defines a list of tag types that will be extracted during the
119 # audio file discovery process. The complete list of possible values can be
120 # found in the mpd.conf man page.
121 #metadata_to_use "artist,album,title,track,name,genre,date,composer,performer,disc"
123 # This setting enables automatic update of MPD's database when files in
124 # music_directory are changed.
128 # Limit the depth of the directories being watched, 0 means only watch
129 # the music directory itself. There is no limit by default.
131 #auto_update_depth "3"
133 ###############################################################################
136 # Symbolic link behavior ######################################################
138 # If this setting is set to "yes", MPD will discover audio files by following
139 # symbolic links outside of the configured music_directory.
141 #follow_outside_symlinks "yes"
143 # If this setting is set to "yes", MPD will discover audio files by following
144 # symbolic links inside of the configured music_directory.
146 #follow_inside_symlinks "yes"
148 ###############################################################################
151 # Zeroconf / Avahi Service Discovery ##########################################
153 # If this setting is set to "yes", service information will be published with
156 #zeroconf_enabled "yes"
158 # The argument to this setting will be the Zeroconf / Avahi unique name for
159 # this MPD server on the network.
161 #zeroconf_name "Music Player"
163 ###############################################################################
166 # Permissions #################################################################
168 # If this setting is set, MPD will require password authorization. The password
169 # can setting can be specified multiple times for different password profiles.
171 #password "password@read,add,control,admin"
173 # This setting specifies the permissions a user has who has not yet logged in.
175 #default_permissions "read,add,control,admin"
177 ###############################################################################
180 # Database #######################################################################
185 # host "other.mpd.host"
189 # Input #######################################################################
194 # proxy "proxy.isp.com:8080"
196 # proxy_password "password"
200 ###############################################################################
202 # Audio Output ################################################################
204 # MPD supports various audio output types, as well as playing through multiple
205 # audio outputs at the same time, through multiple audio_output settings
206 # blocks. Setting this block is optional, though the server will only attempt
207 # autodetection for one sound card.
209 # An example of an ALSA output:
213 # name "My ALSA Device"
214 # device "hw:0,0" # optional
215 # mixer_type "hardware" # optional
216 # mixer_device "default" # optional
217 # mixer_control "PCM" # optional
218 # mixer_index "0" # optional
221 # An example of an OSS output:
225 # name "My OSS Device"
226 # device "/dev/dsp" # optional
227 # mixer_type "hardware" # optional
228 # mixer_device "/dev/mixer" # optional
229 # mixer_control "PCM" # optional
232 # An example of a shout output (for streaming to Icecast):
236 # encoding "ogg" # optional
237 # name "My Shout Stream"
244 # format "44100:16:1"
245 # protocol "icecast2" # optional
246 # user "source" # optional
247 # description "My Stream Description" # optional
248 # url "http://example.com" # optional
249 # genre "jazz" # optional
250 # public "no" # optional
251 # timeout "2" # optional
252 # mixer_type "software" # optional
255 # An example of a recorder output:
260 # encoder "vorbis" # optional, vorbis or lame
261 # path "/var/lib/mpd/recorder/mpd.ogg"
262 ## quality "5.0" # do not define if bitrate is defined
263 # bitrate "128" # do not define if quality is defined
264 # format "44100:16:1"
267 # An example of a httpd output (built-in HTTP streaming server):
271 # name "My HTTP Stream"
272 # encoder "vorbis" # optional, vorbis or lame
274 # bind_to_address "0.0.0.0" # optional, IPv4 or IPv6
275 # quality "5.0" # do not define if bitrate is defined
276 # bitrate "128" # do not define if quality is defined
277 # format "44100:16:1"
278 # max_clients "0" # optional 0=no limit
281 # An example of a pulseaudio output (streaming to a remote pulseaudio server)
282 # Please see README.Debian if you want mpd to play through the pulseaudio
283 # daemon started as part of your graphical desktop session!
287 name "My Pulse Output"
288 # server "remote_server" # optional
289 # sink "remote_server_sink" # optional
292 # An example of a winmm output (Windows multimedia API).
296 # name "My WinMM output"
297 # device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional
299 # device "0" # optional
300 # mixer_type "hardware" # optional
303 # An example of an openal output.
307 # name "My OpenAL output"
308 # device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional
311 ## Example "pipe" output:
316 # command "aplay -f cd 2>/dev/null"
317 ## Or if you're want to use AudioCompress
318 # command "AudioCompress -m | aplay -f cd 2>/dev/null"
319 ## Or to send raw PCM stream through PCM:
320 # command "nc example.org 8765"
321 # format "44100:16:2"
324 ## An example of a null output (for no audio output):
328 # name "My Null Output"
329 # mixer_type "none" # optional
332 # If MPD has been compiled with libsamplerate support, this setting specifies
333 # the sample rate converter to use. Possible values can be found in the
334 # mpd.conf man page or the libsamplerate documentation. By default, this is
335 # setting is disabled.
337 #samplerate_converter "Fastest Sinc Interpolator"
339 ###############################################################################
342 # Normalization automatic volume adjustments ##################################
344 # This setting specifies the type of ReplayGain to use. This setting can have
345 # the argument "off", "album", "track" or "auto". "auto" is a special mode that
346 # chooses between "track" and "album" depending on the current state of
347 # random playback. If random playback is enabled then "track" mode is used.
348 # See <http://www.replaygain.org> for more details about ReplayGain.
349 # This setting is off by default.
353 # This setting sets the pre-amp used for files that have ReplayGain tags. By
354 # default this setting is disabled.
356 #replaygain_preamp "0"
358 # This setting sets the pre-amp used for files that do NOT have ReplayGain tags.
359 # By default this setting is disabled.
361 #replaygain_missing_preamp "0"
363 # This setting enables or disables ReplayGain limiting.
364 # MPD calculates actual amplification based on the ReplayGain tags
365 # and replaygain_preamp / replaygain_missing_preamp setting.
366 # If replaygain_limit is enabled MPD will never amplify audio signal
367 # above its original level. If replaygain_limit is disabled such amplification
368 # might occur. By default this setting is enabled.
370 #replaygain_limit "yes"
372 # This setting enables on-the-fly normalization volume adjustment. This will
373 # result in the volume of all playing audio to be adjusted so the output has
374 # equal "loudness". This setting is disabled by default.
376 #volume_normalization "no"
378 ###############################################################################
381 # Character Encoding ##########################################################
383 # If file or directory names do not display correctly for your locale then you
384 # may need to modify this setting.
386 filesystem_charset "UTF-8"
388 # This setting controls the encoding that ID3v1 tags should be converted from.
390 id3v1_encoding "UTF-8"
392 ###############################################################################
395 # SIDPlay decoder #############################################################
397 # songlength_database:
398 # Location of your songlengths file, as distributed with the HVSC.
399 # The sidplay plugin checks this for matching MD5 fingerprints.
400 # See http://www.c64.org/HVSC/DOCUMENTS/Songlengths.faq
402 # default_songlength:
403 # This is the default playing time in seconds for songs not in the
404 # songlength database, or in case you're not using a database.
405 # A value of 0 means play indefinitely.
408 # Turns the SID filter emulation on or off.
412 # songlength_database "/media/C64Music/DOCUMENTS/Songlengths.txt"
413 # default_songlength "120"
417 ###############################################################################