6ca3755cfe7616c0ca443ab7449467521e7804b7
[~bandali/configs] / mpd / .config / mpd / mpd.conf
1 # An example configuration file for MPD.
2 # Read the user manual for documentation: http://www.musicpd.org/doc/user/
3
4
5 # Files and directories #######################################################
6 #
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.
12 #
13 music_directory "~/music"
14 #
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.
19 #
20 playlist_directory "~/.config/mpd/playlists"
21 #
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.
27 #
28 db_file "~/.config/mpd/database"
29 #
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
32 # settings.
33 #
34 # The special value "syslog" makes MPD use the local syslog daemon. This
35 # setting defaults to logging to syslog, otherwise logging is disabled.
36 #
37 log_file "~/.config/mpd/log"
38 #
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.
42 #
43 pid_file "~/.config/mpd/pid"
44 #
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.
49 #
50 state_file "~/.config/mpd/state"
51 #
52 # The location of the sticker database. This is a database which
53 # manages dynamic information attached to songs.
54 #
55 sticker_file "~/.config/mpd/sticker.sql"
56 #
57 ###############################################################################
58
59
60 # General music daemon options ################################################
61 #
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
65 # current user.
66 #
67 #user "nobody"
68 #
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.
73 #
74 #group "nogroup"
75 #
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.
79 #
80 # For network
81 #bind_to_address "any"
82 #
83 # And for Unix Socket
84 #bind_to_address "~/.mpd/socket"
85 #
86 # This setting is the TCP port that is desired for the daemon to get assigned
87 # to.
88 #
89 #port "6600"
90 #
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.
95 #
96 #log_level "default"
97 #
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.
103 #
104 #gapless_mp3_playback "yes"
105 #
106 # Setting "restore_paused" to "yes" puts MPD into pause mode instead
107 # of starting playback after startup.
108 #
109 #restore_paused "no"
110 #
111 # This setting enables MPD to create playlists in a format usable by other
112 # music players.
113 #
114 #save_absolute_paths_in_playlists "no"
115 #
116 # This setting defines a list of tag types that will be extracted during the
117 # audio file discovery process. The complete list of possible values can be
118 # found in the mpd.conf man page.
119 #metadata_to_use "artist,album,title,track,name,genre,date,composer,performer,disc"
120 #
121 # This setting enables automatic update of MPD's database when files in
122 # music_directory are changed.
123 #
124 #auto_update "yes"
125 #
126 # Limit the depth of the directories being watched, 0 means only watch
127 # the music directory itself. There is no limit by default.
128 #
129 #auto_update_depth "3"
130 #
131 ###############################################################################
132
133
134 # Symbolic link behavior ######################################################
135 #
136 # If this setting is set to "yes", MPD will discover audio files by following
137 # symbolic links outside of the configured music_directory.
138 #
139 #follow_outside_symlinks "yes"
140 #
141 # If this setting is set to "yes", MPD will discover audio files by following
142 # symbolic links inside of the configured music_directory.
143 #
144 #follow_inside_symlinks "yes"
145 #
146 ###############################################################################
147
148
149 # Zeroconf / Avahi Service Discovery ##########################################
150 #
151 # If this setting is set to "yes", service information will be published with
152 # Zeroconf / Avahi.
153 #
154 #zeroconf_enabled "yes"
155 #
156 # The argument to this setting will be the Zeroconf / Avahi unique name for
157 # this MPD server on the network.
158 #
159 #zeroconf_name "Music Player"
160 #
161 ###############################################################################
162
163
164 # Permissions #################################################################
165 #
166 # If this setting is set, MPD will require password authorization. The password
167 # can setting can be specified multiple times for different password profiles.
168 #
169 #password "password@read,add,control,admin"
170 #
171 # This setting specifies the permissions a user has who has not yet logged in.
172 #
173 #default_permissions "read,add,control,admin"
174 #
175 ###############################################################################
176
177
178 # Database #######################################################################
179 #
180
181 #database {
182 # plugin "proxy"
183 # host "other.mpd.host"
184 # port "6600"
185 #}
186
187 # Input #######################################################################
188 #
189
190 input {
191 plugin "curl"
192 # proxy "proxy.isp.com:8080"
193 # proxy_user "user"
194 # proxy_password "password"
195 }
196
197 #
198 ###############################################################################
199
200 # Audio Output ################################################################
201 #
202 # MPD supports various audio output types, as well as playing through multiple
203 # audio outputs at the same time, through multiple audio_output settings
204 # blocks. Setting this block is optional, though the server will only attempt
205 # autodetection for one sound card.
206 #
207 # An example of an ALSA output:
208 #
209 #audio_output {
210 #type "alsa"
211 #name "My ALSA Device"
212 ## device "hw:0,0" # optional
213 ### mixer_type "hardware" # optional
214 ### mixer_device "default" # optional
215 ### mixer_control "PCM" # optional
216 ### mixer_index "0" # optional
217 #}
218
219 audio_output {
220 type "alsa"
221 name "My ALSA Device"
222 }
223
224 audio_output {
225 type "fifo"
226 name "my_fifo"
227 path "/tmp/mpd.fifo"
228 format "44100:16:2"
229 }
230
231 #
232 # An example of an OSS output:
233 #
234 #audio_output {
235 # type "oss"
236 # name "My OSS Device"
237 ## device "/dev/dsp" # optional
238 ## mixer_type "hardware" # optional
239 ## mixer_device "/dev/mixer" # optional
240 ## mixer_control "PCM" # optional
241 #}
242 #
243 # An example of a shout output (for streaming to Icecast):
244 #
245 #audio_output {
246 # type "shout"
247 # encoding "ogg" # optional
248 # name "My Shout Stream"
249 # host "localhost"
250 # port "8000"
251 # mount "/mpd.ogg"
252 # password "hackme"
253 # quality "5.0"
254 # bitrate "128"
255 # format "44100:16:1"
256 ## protocol "icecast2" # optional
257 ## user "source" # optional
258 ## description "My Stream Description" # optional
259 ## url "http://example.com" # optional
260 ## genre "jazz" # optional
261 ## public "no" # optional
262 ## timeout "2" # optional
263 ## mixer_type "software" # optional
264 #}
265 #
266 # An example of a recorder output:
267 #
268 #audio_output {
269 # type "recorder"
270 # name "My recorder"
271 # encoder "vorbis" # optional, vorbis or lame
272 # path "/var/lib/mpd/recorder/mpd.ogg"
273 ## quality "5.0" # do not define if bitrate is defined
274 # bitrate "128" # do not define if quality is defined
275 # format "44100:16:1"
276 #}
277 #
278 # An example of a httpd output (built-in HTTP streaming server):
279 #
280 #audio_output {
281 # type "httpd"
282 # name "My HTTP Stream"
283 # encoder "vorbis" # optional, vorbis or lame
284 # port "8000"
285 # bind_to_address "0.0.0.0" # optional, IPv4 or IPv6
286 ## quality "5.0" # do not define if bitrate is defined
287 # bitrate "128" # do not define if quality is defined
288 # format "44100:16:1"
289 # max_clients "0" # optional 0=no limit
290 #}
291 #
292 # An example of a pulseaudio output (streaming to a remote pulseaudio server)
293 #
294 #audio_output {
295 # type "pulse"
296 # name "My Pulse Output"
297 ## server "remote_server" # optional
298 ## sink "remote_server_sink" # optional
299 #}
300 #
301 # An example of a winmm output (Windows multimedia API).
302 #
303 #audio_output {
304 # type "winmm"
305 # name "My WinMM output"
306 ## device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional
307 # or
308 ## device "0" # optional
309 ## mixer_type "hardware" # optional
310 #}
311 #
312 # An example of an openal output.
313 #
314 #audio_output {
315 # type "openal"
316 # name "My OpenAL output"
317 ## device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional
318 #}
319 #
320 ## Example "pipe" output:
321 #
322 #audio_output {
323 # type "pipe"
324 # name "my pipe"
325 # command "aplay -f cd 2>/dev/null"
326 ## Or if you're want to use AudioCompress
327 # command "AudioCompress -m | aplay -f cd 2>/dev/null"
328 ## Or to send raw PCM stream through PCM:
329 # command "nc example.org 8765"
330 # format "44100:16:2"
331 #}
332 #
333 ## An example of a null output (for no audio output):
334 #
335 #audio_output {
336 # type "null"
337 # name "My Null Output"
338 # mixer_type "none" # optional
339 #}
340 #
341 # If MPD has been compiled with libsamplerate support, this setting specifies
342 # the sample rate converter to use. Possible values can be found in the
343 # mpd.conf man page or the libsamplerate documentation. By default, this is
344 # setting is disabled.
345 #
346 #samplerate_converter "Fastest Sinc Interpolator"
347 #
348 ###############################################################################
349
350
351 # Normalization automatic volume adjustments ##################################
352 #
353 # This setting specifies the type of ReplayGain to use. This setting can have
354 # the argument "off", "album", "track" or "auto". "auto" is a special mode that
355 # chooses between "track" and "album" depending on the current state of
356 # random playback. If random playback is enabled then "track" mode is used.
357 # See <http://www.replaygain.org> for more details about ReplayGain.
358 # This setting is off by default.
359 #
360 #replaygain "album"
361 #
362 # This setting sets the pre-amp used for files that have ReplayGain tags. By
363 # default this setting is disabled.
364 #
365 #replaygain_preamp "0"
366 #
367 # This setting sets the pre-amp used for files that do NOT have ReplayGain tags.
368 # By default this setting is disabled.
369 #
370 #replaygain_missing_preamp "0"
371 #
372 # This setting enables or disables ReplayGain limiting.
373 # MPD calculates actual amplification based on the ReplayGain tags
374 # and replaygain_preamp / replaygain_missing_preamp setting.
375 # If replaygain_limit is enabled MPD will never amplify audio signal
376 # above its original level. If replaygain_limit is disabled such amplification
377 # might occur. By default this setting is enabled.
378 #
379 #replaygain_limit "yes"
380 #
381 # This setting enables on-the-fly normalization volume adjustment. This will
382 # result in the volume of all playing audio to be adjusted so the output has
383 # equal "loudness". This setting is disabled by default.
384 #
385 #volume_normalization "no"
386 #
387 ###############################################################################
388
389
390 # MPD Internal Buffering ######################################################
391 #
392 # This setting adjusts the size of internal decoded audio buffering. Changing
393 # this may have undesired effects. Don't change this if you don't know what you
394 # are doing.
395 #
396 #audio_buffer_size "4096"
397 #
398 # This setting controls the percentage of the buffer which is filled before
399 # beginning to play. Increasing this reduces the chance of audio file skipping,
400 # at the cost of increased time prior to audio playback.
401 #
402 #buffer_before_play "10%"
403 #
404 ###############################################################################
405
406
407 # Resource Limitations ########################################################
408 #
409 # These settings are various limitations to prevent MPD from using too many
410 # resources. Generally, these settings should be minimized to prevent security
411 # risks, depending on the operating resources.
412 #
413 #connection_timeout "60"
414 #max_connections "10"
415 #max_playlist_length "16384"
416 #max_command_list_size "2048"
417 #max_output_buffer_size "8192"
418 #
419 ###############################################################################
420
421 # Character Encoding ##########################################################
422 #
423 # If file or directory names do not display correctly for your locale then you
424 # may need to modify this setting.
425 #
426 #filesystem_charset "UTF-8"
427 #
428 # This setting controls the encoding that ID3v1 tags should be converted from.
429 #
430 #id3v1_encoding "ISO-8859-1"
431 #
432 ###############################################################################
433
434
435 # SIDPlay decoder #############################################################
436 #
437 # songlength_database:
438 # Location of your songlengths file, as distributed with the HVSC.
439 # The sidplay plugin checks this for matching MD5 fingerprints.
440 # See http://www.c64.org/HVSC/DOCUMENTS/Songlengths.faq
441 #
442 # default_songlength:
443 # This is the default playing time in seconds for songs not in the
444 # songlength database, or in case you're not using a database.
445 # A value of 0 means play indefinitely.
446 #
447 # filter:
448 # Turns the SID filter emulation on or off.
449 #
450 #decoder {
451 # plugin "sidplay"
452 # songlength_database "/media/C64Music/DOCUMENTS/Songlengths.txt"
453 # default_songlength "120"
454 # filter "true"
455 #}
456 #
457 ###############################################################################
458