Move user-level configs out of rc.org
[~bandali/configs] / .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 "~/usr/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 "~/.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 "~/.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 "~/.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 "~/.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 "~/.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 "~/.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. Not effective if
79 # systemd socket activiation is in use.
80 #
81 # For network
82 #bind_to_address "any"
83 #
84 # And for Unix Socket
85 #bind_to_address "~/.mpd/socket"
86 #
87 # This setting is the TCP port that is desired for the daemon to get assigned
88 # to.
89 #
90 #port "6600"
91 #
92 # This setting controls the type of information which is logged. Available
93 # setting arguments are "default", "secure" or "verbose". The "verbose" setting
94 # argument is recommended for troubleshooting, though can quickly stretch
95 # available resources on limited hardware storage.
96 #
97 #log_level "default"
98 #
99 # If you have a problem with your MP3s ending abruptly it is recommended that
100 # you set this argument to "no" to attempt to fix the problem. If this solves
101 # the problem, it is highly recommended to fix the MP3 files with vbrfix
102 # (available from <http://www.willwap.co.uk/Programs/vbrfix.php>), at which
103 # point gapless MP3 playback can be enabled.
104 #
105 #gapless_mp3_playback "yes"
106 #
107 # Setting "restore_paused" to "yes" puts MPD into pause mode instead
108 # of starting playback after startup.
109 #
110 #restore_paused "no"
111 #
112 # This setting enables MPD to create playlists in a format usable by other
113 # music players.
114 #
115 #save_absolute_paths_in_playlists "no"
116 #
117 # This setting defines a list of tag types that will be extracted during the
118 # audio file discovery process. The complete list of possible values can be
119 # found in the user manual.
120 #metadata_to_use "artist,album,title,track,name,genre,date,composer,performer,disc"
121 #
122 # This setting enables automatic update of MPD's database when files in
123 # music_directory are changed.
124 #
125 #auto_update "yes"
126 #
127 # Limit the depth of the directories being watched, 0 means only watch
128 # the music directory itself. There is no limit by default.
129 #
130 #auto_update_depth "3"
131 #
132 ###############################################################################
133
134
135 # Symbolic link behavior ######################################################
136 #
137 # If this setting is set to "yes", MPD will discover audio files by following
138 # symbolic links outside of the configured music_directory.
139 #
140 #follow_outside_symlinks "yes"
141 #
142 # If this setting is set to "yes", MPD will discover audio files by following
143 # symbolic links inside of the configured music_directory.
144 #
145 #follow_inside_symlinks "yes"
146 #
147 ###############################################################################
148
149
150 # Zeroconf / Avahi Service Discovery ##########################################
151 #
152 # If this setting is set to "yes", service information will be published with
153 # Zeroconf / Avahi.
154 #
155 #zeroconf_enabled "yes"
156 #
157 # The argument to this setting will be the Zeroconf / Avahi unique name for
158 # this MPD server on the network.
159 #
160 #zeroconf_name "Music Player"
161 #
162 ###############################################################################
163
164
165 # Permissions #################################################################
166 #
167 # If this setting is set, MPD will require password authorization. The password
168 # setting can be specified multiple times for different password profiles.
169 #
170 #password "password@read,add,control,admin"
171 #
172 # This setting specifies the permissions a user has who has not yet logged in.
173 #
174 #default_permissions "read,add,control,admin"
175 #
176 ###############################################################################
177
178
179 # Database #######################################################################
180 #
181
182 #database {
183 # plugin "proxy"
184 # host "other.mpd.host"
185 # port "6600"
186 #}
187
188 # Input #######################################################################
189 #
190
191 input {
192 plugin "curl"
193 # proxy "proxy.isp.com:8080"
194 # proxy_user "user"
195 # proxy_password "password"
196 }
197
198 #
199 ###############################################################################
200
201 # Audio Output ################################################################
202 #
203
204 audio_output {
205 type "pulse"
206 name "pulse audio"
207 }
208
209 audio_output {
210 type "fifo"
211 name "my_fifo"
212 path "/tmp/mpd.fifo"
213 format "44100:16:2"
214 }
215
216 # MPD supports various audio output types, as well as playing through multiple
217 # audio outputs at the same time, through multiple audio_output settings
218 # blocks. Setting this block is optional, though the server will only attempt
219 # autodetection for one sound card.
220 #
221 # An example of an ALSA output:
222 #
223 #audio_output {
224 # type "alsa"
225 # name "My ALSA Device"
226 ## device "hw:0,0" # optional
227 ## mixer_type "hardware" # optional
228 ## mixer_device "default" # optional
229 ## mixer_control "PCM" # optional
230 ## mixer_index "0" # optional
231 #}
232 #
233 # An example of an OSS output:
234 #
235 #audio_output {
236 # type "oss"
237 # name "My OSS Device"
238 ## device "/dev/dsp" # optional
239 ## mixer_type "hardware" # optional
240 ## mixer_device "/dev/mixer" # optional
241 ## mixer_control "PCM" # optional
242 #}
243 #
244 # An example of a shout output (for streaming to Icecast):
245 #
246 #audio_output {
247 # type "shout"
248 # encoder "vorbis" # optional
249 # name "My Shout Stream"
250 # host "localhost"
251 # port "8000"
252 # mount "/mpd.ogg"
253 # password "hackme"
254 # quality "5.0"
255 # bitrate "128"
256 # format "44100:16:1"
257 ## protocol "icecast2" # optional
258 ## user "source" # optional
259 ## description "My Stream Description" # optional
260 ## url "http://example.com" # optional
261 ## genre "jazz" # optional
262 ## public "no" # optional
263 ## timeout "2" # optional
264 ## mixer_type "software" # optional
265 #}
266 #
267 # An example of a recorder output:
268 #
269 #audio_output {
270 # type "recorder"
271 # name "My recorder"
272 # encoder "vorbis" # optional, vorbis or lame
273 # path "/var/lib/mpd/recorder/mpd.ogg"
274 ## quality "5.0" # do not define if bitrate is defined
275 # bitrate "128" # do not define if quality is defined
276 # format "44100:16:1"
277 #}
278 #
279 # An example of a httpd output (built-in HTTP streaming server):
280 #
281 #audio_output {
282 # type "httpd"
283 # name "My HTTP Stream"
284 # encoder "vorbis" # optional, vorbis or lame
285 # port "8000"
286 # bind_to_address "0.0.0.0" # optional, IPv4 or IPv6
287 ## quality "5.0" # do not define if bitrate is defined
288 # bitrate "128" # do not define if quality is defined
289 # format "44100:16:1"
290 # max_clients "0" # optional 0=no limit
291 #}
292 #
293 # An example of a pulseaudio output (streaming to a remote pulseaudio server)
294 #
295 #audio_output {
296 # type "pulse"
297 # name "My Pulse Output"
298 ## server "remote_server" # optional
299 ## sink "remote_server_sink" # optional
300 #}
301 #
302 # An example of a winmm output (Windows multimedia API).
303 #
304 #audio_output {
305 # type "winmm"
306 # name "My WinMM output"
307 ## device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional
308 # or
309 ## device "0" # optional
310 ## mixer_type "hardware" # optional
311 #}
312 #
313 # An example of an openal output.
314 #
315 #audio_output {
316 # type "openal"
317 # name "My OpenAL output"
318 ## device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional
319 #}
320 #
321 # An example of an sndio output.
322 #
323 #audio_output {
324 # type "sndio"
325 # name "sndio output"
326 # mixer_type "software"
327 #}
328 #
329 # An example of an OS X output:
330 #
331 #audio_output {
332 # type "osx"
333 # name "My OS X Device"
334 ## device "Built-in Output" # optional
335 ## channel_map "-1,-1,0,1" # optional
336 #}
337 #
338 ## Example "pipe" output:
339 #
340 #audio_output {
341 # type "pipe"
342 # name "my pipe"
343 # command "aplay -f cd 2>/dev/null"
344 ## Or if you're want to use AudioCompress
345 # command "AudioCompress -m | aplay -f cd 2>/dev/null"
346 ## Or to send raw PCM stream through PCM:
347 # command "nc example.org 8765"
348 # format "44100:16:2"
349 #}
350 #
351 ## An example of a null output (for no audio output):
352 #
353 #audio_output {
354 # type "null"
355 # name "My Null Output"
356 # mixer_type "none" # optional
357 #}
358 #
359 ###############################################################################
360
361
362 # Normalization automatic volume adjustments ##################################
363 #
364 # This setting specifies the type of ReplayGain to use. This setting can have
365 # the argument "off", "album", "track" or "auto". "auto" is a special mode that
366 # chooses between "track" and "album" depending on the current state of
367 # random playback. If random playback is enabled then "track" mode is used.
368 # See <http://www.replaygain.org> for more details about ReplayGain.
369 # This setting is off by default.
370 #
371 #replaygain "album"
372 #
373 # This setting sets the pre-amp used for files that have ReplayGain tags. By
374 # default this setting is disabled.
375 #
376 #replaygain_preamp "0"
377 #
378 # This setting sets the pre-amp used for files that do NOT have ReplayGain tags.
379 # By default this setting is disabled.
380 #
381 #replaygain_missing_preamp "0"
382 #
383 # This setting enables or disables ReplayGain limiting.
384 # MPD calculates actual amplification based on the ReplayGain tags
385 # and replaygain_preamp / replaygain_missing_preamp setting.
386 # If replaygain_limit is enabled MPD will never amplify audio signal
387 # above its original level. If replaygain_limit is disabled such amplification
388 # might occur. By default this setting is enabled.
389 #
390 #replaygain_limit "yes"
391 #
392 # This setting enables on-the-fly normalization volume adjustment. This will
393 # result in the volume of all playing audio to be adjusted so the output has
394 # equal "loudness". This setting is disabled by default.
395 #
396 #volume_normalization "no"
397 #
398 ###############################################################################
399
400 # Character Encoding ##########################################################
401 #
402 # If file or directory names do not display correctly for your locale then you
403 # may need to modify this setting.
404 #
405 #filesystem_charset "UTF-8"
406 #
407 ###############################################################################