Commit | Line | Data |
---|---|---|
ca3a844a AB |
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 | ############################################################################### |