1 # Files and directories #######################################################
3 # This setting controls the top directory which MPD will search to discover the
4 # available audio files and add them to the daemon's online database. This
5 # setting defaults to the XDG directory, otherwise the music directory will be
6 # be disabled and audio files will only be accepted over ipc socket (using
7 # file:// protocol) or streaming files over an accepted protocol.
9 music_directory "/mnt/data/beets"
11 # This setting sets the MPD internal playlist directory. The purpose of this
12 # directory is storage for playlists created by MPD. The server will use
13 # playlist files not created by the server but only if they are in the MPD
14 # format. This setting defaults to playlist saving being disabled.
16 playlist_directory "/var/lib/mpd/playlists"
18 # This setting sets the location of the MPD database. This file is used to
19 # load the database at server start up and store the database while the
20 # server is not up. This setting defaults to disabled which will allow
21 # MPD to accept files over ipc socket (using file:// protocol) or streaming
22 # files over an accepted protocol.
24 db_file "/var/lib/mpd/tag_cache"
26 # These settings are the locations for the daemon log files for the daemon.
27 # These logs are great for troubleshooting, depending on your log_level
30 # The special value "syslog" makes MPD use the local syslog daemon. This
31 # setting defaults to logging to syslog, otherwise logging is disabled.
33 log_file "/var/log/mpd/mpd.log"
35 # This setting sets the location of the file which stores the process ID
36 # for use of mpd --kill and some init scripts. This setting is disabled by
37 # default and the pid file will not be stored.
39 pid_file "/var/run/mpd/pid"
41 # This setting sets the location of the file which contains information about
42 # most variables to get MPD back into the same general shape it was in before
43 # it was brought down. This setting is disabled by default and the server
44 # state will be reset on server start up.
46 state_file "/var/lib/mpd/state"
48 # The location of the sticker database. This is a database which
49 # manages dynamic information attached to songs.
51 sticker_file "/var/lib/mpd/sticker.sql"
53 ###############################################################################
56 # General music daemon options ################################################
58 # This setting specifies the user that MPD will run as. MPD should never run as
59 # root and you may use this setting to make MPD change its user ID after
60 # initialization. This setting is disabled by default and MPD is run as the
65 # This setting specifies the group that MPD will run as. If not specified
66 # primary group of user specified with "user" setting will be used (if set).
67 # This is useful if MPD needs to be a member of group such as "audio" to
68 # have permission to use sound card.
72 # This setting sets the address for the daemon to listen on. Careful attention
73 # should be paid if this is assigned to anything other then the default, any.
74 # This setting can deny access to control of the daemon. Choose any if you want
75 # to have mpd listen on every address
78 bind_to_address "0.0.0.0"
81 #bind_to_address "/var/run/mpd/socket"
83 # This setting is the TCP port that is desired for the daemon to get assigned
88 # This setting controls the type of information which is logged. Available
89 # setting arguments are "default", "secure" or "verbose". The "verbose" setting
90 # argument is recommended for troubleshooting, though can quickly stretch
91 # available resources on limited hardware storage.
95 # If you have a problem with your MP3s ending abruptly it is recommended that
96 # you set this argument to "no" to attempt to fix the problem. If this solves
97 # the problem, it is highly recommended to fix the MP3 files with vbrfix
98 # (available as vbrfix in the debian archive), at which
99 # point gapless MP3 playback can be enabled.
101 #gapless_mp3_playback "yes"
103 # This setting enables MPD to create playlists in a format usable by other
106 #save_absolute_paths_in_playlists "no"
108 # This setting defines a list of tag types that will be extracted during the
109 # audio file discovery process. Optionally, 'comment' can be added to this
112 #metadata_to_use "artist,album,title,track,name,genre,date,composer,performer,disc"
114 # This setting enables automatic update of MPD's database when files in
115 # music_directory are changed.
119 # Limit the depth of the directories being watched, 0 means only watch
120 # the music directory itself. There is no limit by default.
122 #auto_update_depth "3"
124 ###############################################################################
127 # Symbolic link behavior ######################################################
129 # If this setting is set to "yes", MPD will discover audio files by following
130 # symbolic links outside of the configured music_directory.
132 #follow_outside_symlinks "yes"
134 # If this setting is set to "yes", MPD will discover audio files by following
135 # symbolic links inside of the configured music_directory.
137 #follow_inside_symlinks "yes"
139 ###############################################################################
142 # Zeroconf / Avahi Service Discovery ##########################################
144 # If this setting is set to "yes", service information will be published with
147 #zeroconf_enabled "yes"
149 # The argument to this setting will be the Zeroconf / Avahi unique name for
150 # this MPD server on the network.
152 #zeroconf_name "Music Player"
154 ###############################################################################
157 # Permissions #################################################################
159 # If this setting is set, MPD will require password authorization. The password
160 # can setting can be specified multiple times for different password profiles.
162 #password "password@read,add,control,admin"
164 # This setting specifies the permissions a user has who has not yet logged in.
166 #default_permissions "read,add,control,admin"
168 ###############################################################################
171 # Input #######################################################################
176 # proxy "proxy.isp.com:8080"
178 # proxy_password "password"
182 ###############################################################################
184 # Audio Output ################################################################
186 # MPD supports various audio output types, as well as playing through multiple
187 # audio outputs at the same time, through multiple audio_output settings
188 # blocks. Setting this block is optional, though the server will only attempt
189 # autodetection for one sound card.
191 # See <http://mpd.wikia.com/wiki/Configuration#Audio_Outputs> for examples of
192 # other audio outputs.
194 # An example of an ALSA output:
198 # name "My ALSA Device"
199 # device "hw:0,0" # optional
200 # format "44100:16:2" # optional
201 # mixer_device "default" # optional
202 # mixer_control "Master" # optional
203 # mixer_index "0" # optional
206 # An example of an OSS output:
210 # name "My OSS Device"
211 # device "/dev/dsp" # optional
212 # format "44100:16:2" # optional
213 # mixer_device "/dev/mixer" # optional
214 # mixer_control "PCM" # optional
217 # An example of a shout output (for streaming to Icecast):
221 # encoding "ogg" # optional
222 # name "My Shout Stream"
229 # format "44100:16:1"
230 # protocol "icecast2" # optional
231 # user "source" # optional
232 # description "My Stream Description" # optional
233 # genre "jazz" # optional
234 # public "no" # optional
235 # timeout "2" # optional
238 # An example of a recorder output:
243 # encoder "vorbis" # optional, vorbis or lame
244 # path "/var/lib/mpd/recorder/mpd.ogg"
245 ## quality "5.0" # do not define if bitrate is defined
246 # bitrate "128" # do not define if quality is defined
247 # format "44100:16:1"
250 # An example of a httpd output (built-in HTTP streaming server):
254 name "My HTTP Stream"
260 # An example of a pulseaudio output (streaming to a remote pulseaudio server)
264 # name "My Pulse Output"
265 # server "remote_server" # optional
266 # sink "remote_server_sink" # optional
269 ## Example "pipe" output:
274 # command "aplay -f cd 2>/dev/null"
275 ## Or if you're want to use AudioCompress
276 # command "AudioCompress -m | aplay -f cd 2>/dev/null"
277 ## Or to send raw PCM stream through PCM:
278 # command "nc example.org 8765"
279 # format "44100:16:2"
282 ## An example of a null output (for no audio output):
286 # name "My Null Output"
289 # This setting will change all decoded audio to be converted to the specified
290 # format before being passed to the audio outputs. By default, this setting is
293 #audio_output_format "44100:16:2"
295 # If MPD has been compiled with libsamplerate support, this setting specifies
296 # the sample rate converter to use. Possible values can be found in the
297 # mpd.conf man page or the libsamplerate documentation. By default, this is
298 # setting is disabled.
300 #samplerate_converter "Fastest Sinc Interpolator"
302 ###############################################################################
305 # Volume control mixer ########################################################
307 # These are the global volume control settings. By default, this setting will
308 # be detected to the available audio output device, with preference going to
309 # hardware mixing. Hardware and software mixers for individual audio_output
310 # sections cannot yet be mixed.
312 # An example for controlling an ALSA, OSS or Pulseaudio mixer; If this
313 # setting is used other sound applications will be affected by the volume
314 # being controlled by MPD.
316 #mixer_type "hardware"
318 # An example for controlling all mixers through software. This will control
319 # all controls, even if the mixer is not supported by the device and will not
320 # affect any other sound producing applications.
322 #mixer_type "software"
324 # This example will not allow MPD to touch the mixer at all and will disable
325 # all volume controls.
327 #mixer_type "disabled"
329 ###############################################################################
332 # Normalization automatic volume adjustments ##################################
334 # This setting specifies the type of ReplayGain to use. This setting can have
335 # the argument "album" or "track". See <http://www.replaygain.org> for more
336 # details. This setting is disabled by default.
340 # This setting sets the pre-amp used for files that have ReplayGain tags. By
341 # default this setting is disabled.
343 #replaygain_preamp "0"
345 # This setting enables on-the-fly normalization volume adjustment. This will
346 # result in the volume of all playing audio to be adjusted so the output has
347 # equal "loudness". This setting is disabled by default.
349 #volume_normalization "no"
351 ###############################################################################
354 # MPD Internal Buffering ######################################################
356 # This setting adjusts the size of internal decoded audio buffering. Changing
357 # this may have undesired effects. Don't change this if you don't know what you
360 #audio_buffer_size "2048"
362 # This setting controls the percentage of the buffer which is filled before
363 # beginning to play. Increasing this reduces the chance of audio file skipping,
364 # at the cost of increased time prior to audio playback.
366 #buffer_before_play "10%"
368 ###############################################################################
371 # Resource Limitations ########################################################
373 # These settings are various limitations to prevent MPD from using too many
374 # resources. Generally, these settings should be minimized to prevent security
375 # risks, depending on the operating resources.
377 #connection_timeout "60"
378 #max_connections "10"
379 #max_playlist_length "16384"
380 #max_command_list_size "2048"
381 #max_output_buffer_size "8192"
383 ###############################################################################
386 # Character Encoding ##########################################################
388 # If file or directory names do not display correctly for your locale then you
389 # may need to modify this setting. After modification of this setting mpd
390 # --create-db must be run to change the database.
392 filesystem_charset "UTF-8"
394 # This setting controls the encoding that ID3v1 tags should be converted from.
396 id3v1_encoding "UTF-8"
398 ###############################################################################
399 # SIDPlay decoder #############################################################
401 # songlength_database:
402 # Location of your songlengths file, as distributed with the HVSC.
403 # The sidplay plugin checks this for matching MD5 fingerprints.
404 # See http://www.c64.org/HVSC/DOCUMENTS/Songlengths.faq
406 # default_songlength:
407 # This is the default playing time in seconds for songs not in the
408 # songlength database, or in case you're not using a database.
409 # A value of 0 means play indefinitely.
412 # Turns the SID filter emulation on or off.
416 # songlength_database "/media/C64Music/DOCUMENTS/Songlengths.txt"
417 # default_songlength "120"
421 ###############################################################################