1 # An example configuration file for MPD
2 # See the mpd.conf man page for a more detailed description of each parameter.
5 # Files and directories #######################################################
7 # This setting controls the top directory which MPD will search to discover the
8 # available audio files and add them to the daemon's online database. This
9 # setting defaults to the XDG directory, otherwise the music directory will be
10 # be disabled and audio files will only be accepted over ipc socket (using
11 # file:// protocol) or streaming files over an accepted protocol.
13 #music_directory "~/music"
15 # This setting sets the MPD internal playlist directory. The purpose of this
16 # directory is storage for playlists created by MPD. The server will use
17 # playlist files not created by the server but only if they are in the MPD
18 # format. This setting defaults to playlist saving being disabled.
20 #playlist_directory "/var/lib/mpd/playlists"
22 # This setting sets the location of the MPD database. This file is used to
23 # load the database at server start up and store the database while the
24 # server is not up. This setting defaults to disabled which will allow
25 # MPD to accept files over ipc socket (using file:// protocol) or streaming
26 # files over an accepted protocol.
28 #db_file "/var/lib/mpd/mpd.db"
30 # These settings are the locations for the daemon log files for the daemon.
31 # These logs are great for troubleshooting, depending on your log_level
34 # The special value "syslog" makes MPD use the local syslog daemon. This
35 # setting defaults to logging to syslog, otherwise logging is disabled.
37 #log_file "/var/log/mpd/mpd.log"
39 # This setting sets the location of the file which stores the process ID
40 # for use of mpd --kill and some init scripts. This setting is disabled by
41 # default and the pid file will not be stored.
43 pid_file "/var/run/mpd/mpd.pid"
45 # This setting sets the location of the file which contains information about
46 # most variables to get MPD back into the same general shape it was in before
47 # it was brought down. This setting is disabled by default and the server
48 # state will be reset on server start up.
50 state_file "/var/lib/mpd/mpdstate"
52 # The location of the sticker database. This is a database which
53 # manages dynamic information attached to songs.
55 #sticker_file "~/.mpd/sticker.sql"
57 ###############################################################################
60 # General music daemon options ################################################
62 # This setting specifies the user that MPD will run as. MPD should never run as
63 # root and you may use this setting to make MPD change its user ID after
64 # initialization. This setting is disabled by default and MPD is run as the
69 # This setting specifies the group that MPD will run as. If not specified
70 # primary group of user specified with "user" setting will be used (if set).
71 # This is useful if MPD needs to be a member of group such as "audio" to
72 # have permission to use sound card.
76 # This setting sets the address for the daemon to listen on. Careful attention
77 # should be paid if this is assigned to anything other then the default, any.
78 # This setting can deny access to control of the daemon.
81 #bind_to_address "any"
84 #bind_to_address "~/.mpd/socket"
86 # This setting is the TCP port that is desired for the daemon to get assigned
91 # This setting controls the type of information which is logged. Available
92 # setting arguments are "default", "secure" or "verbose". The "verbose" setting
93 # argument is recommended for troubleshooting, though can quickly stretch
94 # available resources on limited hardware storage.
98 # If you have a problem with your MP3s ending abruptly it is recommended that
99 # you set this argument to "no" to attempt to fix the problem. If this solves
100 # the problem, it is highly recommended to fix the MP3 files with vbrfix
101 # (available from <http://www.willwap.co.uk/Programs/vbrfix.php>), at which
102 # point gapless MP3 playback can be enabled.
104 #gapless_mp3_playback "yes"
106 # This setting enables MPD to create playlists in a format usable by other
109 #save_absolute_paths_in_playlists "no"
111 # This setting defines a list of tag types that will be extracted during the
112 # audio file discovery process. Optionally, 'comment' can be added to this
115 #metadata_to_use "artist,album,title,track,name,genre,date,composer,performer,disc"
117 # This setting enables automatic update of MPD's database when files in
118 # music_directory are changed.
122 # Limit the depth of the directories being watched, 0 means only watch
123 # the music directory itself. There is no limit by default.
125 #auto_update_depth "3"
127 ###############################################################################
130 # Symbolic link behavior ######################################################
132 # If this setting is set to "yes", MPD will discover audio files by following
133 # symbolic links outside of the configured music_directory.
135 #follow_outside_symlinks "yes"
137 # If this setting is set to "yes", MPD will discover audio files by following
138 # symbolic links inside of the configured music_directory.
140 #follow_inside_symlinks "yes"
142 ###############################################################################
145 # Zeroconf / Avahi Service Discovery ##########################################
147 # If this setting is set to "yes", service information will be published with
150 #zeroconf_enabled "yes"
152 # The argument to this setting will be the Zeroconf / Avahi unique name for
153 # this MPD server on the network.
155 #zeroconf_name "Music Player"
157 ###############################################################################
160 # Permissions #################################################################
162 # If this setting is set, MPD will require password authorization. The password
163 # can setting can be specified multiple times for different password profiles.
165 #password "password@read,add,control,admin"
167 # This setting specifies the permissions a user has who has not yet logged in.
169 #default_permissions "read,add,control,admin"
171 ###############################################################################
174 # Input #######################################################################
179 # proxy "proxy.isp.com:8080"
181 # proxy_password "password"
185 ###############################################################################
187 # Audio Output ################################################################
189 # MPD supports various audio output types, as well as playing through multiple
190 # audio outputs at the same time, through multiple audio_output settings
191 # blocks. Setting this block is optional, though the server will only attempt
192 # autodetection for one sound card.
194 # See <http://mpd.wikia.com/wiki/Configuration#Audio_Outputs> for examples of
195 # other audio outputs.
197 # An example of an ALSA output:
201 # name "My ALSA Device"
202 ## device "hw:0,0" # optional
203 ## format "44100:16:2" # optional
204 ## mixer_type "hardware" # optional
205 ## mixer_device "default" # optional
206 ## mixer_control "PCM" # optional
207 ## mixer_index "0" # optional
210 # An example of an OSS output:
214 # name "My OSS Device"
215 ## device "/dev/dsp" # optional
216 ## format "44100:16:2" # optional
217 ## mixer_type "hardware" # optional
218 ## mixer_device "/dev/mixer" # optional
219 ## mixer_control "PCM" # optional
222 # An example of a shout output (for streaming to Icecast):
226 # encoding "ogg" # optional
227 # name "My Shout Stream"
234 # format "44100:16:1"
235 ## protocol "icecast2" # optional
236 ## user "source" # optional
237 ## description "My Stream Description" # optional
238 ## genre "jazz" # optional
239 ## public "no" # optional
240 ## timeout "2" # optional
241 ## mixer_type "software" # optional
244 # An example of a recorder output:
249 # encoder "vorbis" # optional, vorbis or lame
250 # path "/var/lib/mpd/recorder/mpd.ogg"
251 ## quality "5.0" # do not define if bitrate is defined
252 # bitrate "128" # do not define if quality is defined
253 # format "44100:16:1"
256 # An example of a httpd output (built-in HTTP streaming server):
260 # name "My HTTP Stream"
261 # encoder "vorbis" # optional, vorbis or lame
263 # bind_to_address "0.0.0.0" # optional, IPv4 or IPv6
264 ## quality "5.0" # do not define if bitrate is defined
265 # bitrate "128" # do not define if quality is defined
266 # format "44100:16:1"
267 # max_clients "0" # optional 0=no limit
270 # An example of a pulseaudio output (streaming to a remote pulseaudio server)
274 # name "My Pulse Output"
275 ## server "remote_server" # optional
276 ## sink "remote_server_sink" # optional
279 ## Example "pipe" output:
284 # command "aplay -f cd 2>/dev/null"
285 ## Or if you're want to use AudioCompress
286 # command "AudioCompress -m | aplay -f cd 2>/dev/null"
287 ## Or to send raw PCM stream through PCM:
288 # command "nc example.org 8765"
289 # format "44100:16:2"
292 ## An example of a null output (for no audio output):
296 # name "My Null Output"
297 # mixer_type "none" # optional
300 # This setting will change all decoded audio to be converted to the specified
301 # format before being passed to the audio outputs. By default, this setting is
304 #audio_output_format "44100:16:2"
306 # If MPD has been compiled with libsamplerate support, this setting specifies
307 # the sample rate converter to use. Possible values can be found in the
308 # mpd.conf man page or the libsamplerate documentation. By default, this is
309 # setting is disabled.
311 #samplerate_converter "Fastest Sinc Interpolator"
313 ###############################################################################
316 # Normalization automatic volume adjustments ##################################
318 # This setting specifies the type of ReplayGain to use. This setting can have
319 # the argument "off", "album" or "track". See <http://www.replaygain.org>
320 # for more details. This setting is off by default.
324 # This setting sets the pre-amp used for files that have ReplayGain tags. By
325 # default this setting is disabled.
327 #replaygain_preamp "0"
329 # This setting enables on-the-fly normalization volume adjustment. This will
330 # result in the volume of all playing audio to be adjusted so the output has
331 # equal "loudness". This setting is disabled by default.
333 #volume_normalization "no"
335 ###############################################################################
338 # MPD Internal Buffering ######################################################
340 # This setting adjusts the size of internal decoded audio buffering. Changing
341 # this may have undesired effects. Don't change this if you don't know what you
344 #audio_buffer_size "2048"
346 # This setting controls the percentage of the buffer which is filled before
347 # beginning to play. Increasing this reduces the chance of audio file skipping,
348 # at the cost of increased time prior to audio playback.
350 #buffer_before_play "10%"
352 ###############################################################################
355 # Resource Limitations ########################################################
357 # These settings are various limitations to prevent MPD from using too many
358 # resources. Generally, these settings should be minimized to prevent security
359 # risks, depending on the operating resources.
361 #connection_timeout "60"
362 #max_connections "10"
363 #max_playlist_length "16384"
364 #max_command_list_size "2048"
365 #max_output_buffer_size "8192"
367 ###############################################################################
370 # Character Encoding ##########################################################
372 # If file or directory names do not display correctly for your locale then you
373 # may need to modify this setting.
375 #filesystem_charset "UTF-8"
377 # This setting controls the encoding that ID3v1 tags should be converted from.
379 #id3v1_encoding "ISO-8859-1"
381 ###############################################################################
384 # SIDPlay decoder #############################################################
386 # songlength_database:
387 # Location of your songlengths file, as distributed with the HVSC.
388 # The sidplay plugin checks this for matching MD5 fingerprints.
389 # See http://www.c64.org/HVSC/DOCUMENTS/Songlengths.faq
391 # default_songlength:
392 # This is the default playing time in seconds for songs not in the
393 # songlength database, or in case you're not using a database.
394 # A value of 0 means play indefinitely.
397 # Turns the SID filter emulation on or off.
401 # songlength_database "/media/C64Music/DOCUMENTS/Songlengths.txt"
402 # default_songlength "120"
406 ###############################################################################