1 # An example configuration file for MPD
2 # See the mpd.conf man page for a more detailed description of each parameter.
4 # Required files and directories ##############################################
6 # This setting controls the top directory which MPD will search to discover the
7 # available audio files and add them to the daemon's online database.
9 #music_directory "~/music"
10 music_directory "/media/content"
12 # This setting sets the MPD internal playlist directory. The purpose of this
13 # directory is storage for playlists created by MPD. The server will use
14 # playlist files not created by the server but only if they are in the MPD
17 #playlist_directory "~/.mpd/playlists"
18 playlist_directory "/var/lib/mpd/playlists"
20 # This setting sets the location of the MPD database. This file is used to
21 # load the database at server start up and store the database while the
24 #db_file "~/.mpd/database"
25 db_file "/var/lib/mpd/mpd.db"
27 # These settings are the locations for the daemon log files for the daemon.
28 # These logs are great for troubleshooting, depending on your log_level
31 #log_file "~/.mpd/log"
32 #error_file "~/.mpd/error-log"
33 log_file "/var/lib/mpd/mpd.log"
34 error_file "/var/lib/mpd/mpd.error"
35 ###############################################################################
38 # Optional files ##############################################################
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
44 #pid_file "~/.mpd/pid"
45 pid_file "/var/lib/mpd/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.
50 #state_file "~/.mpd/state"
51 state_file "/var/lib/mpd/mpdstate"
53 ###############################################################################
56 # General music daemon options ################################################
58 # This setting specifies the user that MPD will run as, if set. MPD should
59 # never run as root and you may use this setting to make MPD change its user
60 # id after initialization. Do not use this setting if you start MPD as an
61 # unprivileged user. This setting is disabled by default, and the server will
66 # This setting sets the address for the daemon to listen on. Careful attention
67 # should be paid if this is assigned to anything other then the default, any.
68 # This setting can deny access to control of the daemon.
72 #bind_to_address "127.0.0.1"
75 #bind_to_address "~/.mpd/socket"
77 # This setting is the port that is desired for the daemon to get assigned to.
81 # This setting controls the type of information which is logged. Available
82 # setting arguments are "default", "secure" or "verbose". The "verbose" setting
83 # argument is recommended for troubleshooting, though can quickly stretch
84 # available resources on limited hardware storage.
88 # If you have a problem with your MP3s ending abruptly it is recommended that
89 # you set this argument to "no" to attempt to fix the problem. If this solves
90 # the problem, it is highly recommended to fix the MP3 files with vbrfix
91 # (available from <http://www.willwap.co.uk/Programs/vbrfix.php>), at which
92 # point gapless MP3 playback can be enabled.
94 #gapless_mp3_playback "yes"
96 # This setting enables MPD to create playlists in a format usable by other
99 #save_absolute_paths_in_playlists "no"
101 # This setting defines a list of tag types that will be extracted during the
102 # audio file discovery process. Optionally, 'comment' can be added to this
105 #metadata_to_use "artist,album,title,track,name,genre,date,composer,performer,disc"
107 ###############################################################################
109 # Symbolic link behavior ######################################################
111 # If this setting is set to "yes", MPD will discover audio files by following
112 # symbolic links outside of the configured music_directory.
114 #follow_outside_symlinks "yes"
116 # If this setting is set to "yes, MPD will discover audio files by following
117 # symbolic links inside of the configured music_directory.
119 #follow_inside_symlinks "yes"
121 ###############################################################################
123 # Zeroconf / Avahi Service Discovery ##########################################
125 # If this setting is set to "yes", service information will be published with
128 #zeroconf_enabled "yes"
130 # The argument to this setting will be the Zeroconf / Avahi unique name for
131 # this MPD server on the network.
133 #zeroconf_name "Music Player"
135 ###############################################################################
138 # Permissions #################################################################
140 # If this setting is set, MPD will require password authorization. The password
141 # can setting can be specified multiple times for different password profiles.
143 #password "password@read,add,control,admin"
145 # This setting specifies the permissions a user has who has not yet logged in.
147 #default_permissions "read,add,control,admin"
149 ###############################################################################
152 # Audio Output ################################################################
154 # MPD supports various audio output types, as well as playing through multiple
155 # audio outputs at the same time, through multiple audio_output settings
156 # blocks. Setting this block is optional, though the server will only attempt
157 # autodetection for one sound card.
159 # See <http://mpd.wikia.com/wiki/Configuration#Audio_Outputs> for examples of
160 # other audio outputs.
162 # An example of an ALSA output:
166 # name "My ALSA Device"
167 # device "hw:0,0" # optional
168 # format "44100:16:2" # optional
171 # An example of an OSS output:
175 # name "My OSS Device"
176 # device "/dev/dsp" # optional
177 # format "44100:16:2" # optional
180 # An example of a shout output (for streaming to Icecast):
184 # encoding "ogg" # optional
185 # name "My Shout Stream"
192 # format "44100:16:1"
193 # protocol "icecast2" # optional
194 # user "source" # optional
195 # description "My Stream Description" # optional
196 # genre "jazz" # optional
197 # public "no" # optional
198 # timeout "2" # optional
201 # An example of a pulseaudio output (streaming to a remote pulseaudio server)
205 # name "My Pulse Output"
206 # server "remote_server"
207 # sink "remote_server_sink"
210 ## An example of a null output (for no audio output):
214 # name "My Null Output"
217 # This setting will change all decoded audio to be converted to the specified
218 # format before being passed to the audio outputs. By default, this setting is
221 #audio_output_format "44100:16:2"
223 # If MPD has been compiled with libsamplerate support, this setting specifies
224 # the sample rate converter to use. Possible values can be found in the
225 # mpd.conf man page or the libsamplerate documentation. By default, this is
226 # setting is disabled.
228 #samplerate_converter "Fastest Sinc Interpolator"
230 ###############################################################################
233 # Volume control mixer ########################################################
235 # MPD has limited volume controls, to use them pick one below. If one is not
236 # specified it may be autodetected at startup, depending on the dependencies
237 # which were compiled into the server.
239 # An example for controlling an ALSA mixer:
242 mixer_device "default"
245 # An example for controlling an OSS mixer:
248 #mixer_device "/dev/mixer"
251 # This example is a general volume control mixer, it is used to adjust the
252 # volume of the audio sent to the audio output, and will work with all outputs.
254 #mixer_type "software"
256 ###############################################################################
259 # Normalization automatic volume adjustments ##################################
261 # This setting specifies the type of ReplayGain to use. This setting can have
262 # the argument "album" or "track". See <http://www.replaygain.org> for more
263 # details. By default this setting is disabled.
267 # This setting sets the pre-amp used for files that have ReplayGain tags. By
268 # default this setting is disabled.
270 #replaygain_preamp "0"
272 # This setting enables on-the-fly normalization volume adjustment. This will
273 # result in the volume of all playing audio to be adjusted so the output has
276 #volume_normalization "no"
278 ###############################################################################
281 # MPD Internal Buffering ######################################################
283 # This setting adjusts the size of internal decoded audio buffering. Changing
284 # this may have undesired effects. Don't change this if you don't know what you
287 #audio_buffer_size "2048"
289 # This setting controls the percentage of the buffer which is filled before
290 # beginning to play. Increasing this reduces the chance of audio file skipping,
291 # at the cost of increased time prior to audio playback.
293 #buffer_before_play "10%"
295 ###############################################################################
298 # HTTP Streaming Proxy ########################################################
300 # This setting specifies the HTTP proxy to use for playing HTTP streams. By
301 # default, these settings will be disabled.
303 #http_proxy_host "proxy.isp.com"
304 #http_proxy_port "8080"
305 #http_proxy_user "user"
306 #http_proxy_password "password"
308 ###############################################################################
311 # Resource Limitations ########################################################
313 # These settings are various limitations to prevent MPD from using too many
314 # resources. Generally, these settings should be minimized to prevent security
315 # risks, depending on the operating resources.
317 #connection_timeout "60"
318 #max_connections "10"
319 #max_playlist_length "16384"
320 #max_command_list_size "2048"
321 #max_output_buffer_size "8192"
323 ###############################################################################
326 # Character Encoding ##########################################################
328 # If file or directory names do not display correctly for your locale then you
329 # may need to modify this setting. After modification of this setting mpd
330 # --create-db must be run to change the database.
332 filesystem_charset "UTF-8"
334 # This setting controls the encoding that ID3v1 tags should be converted from.
336 #id3v1_encoding "ISO-8859-1"
338 ###############################################################################