]> git.donarmstrong.com Git - x_base.git/blob - .mpdconf
update awesome configuration for newer versions of awesome
[x_base.git] / .mpdconf
1 # An example configuration file for MPD.
2 # Read the user manual for documentation: http://www.musicpd.org/doc/user/
3 # or /usr/share/doc/mpd/user-manual.html
4
5
6 # Files and directories #######################################################
7 #
8 # This setting controls the top directory which MPD will search to discover the
9 # available audio files and add them to the daemon's online database. This 
10 # setting defaults to the XDG directory, otherwise the music directory will be
11 # be disabled and audio files will only be accepted over ipc socket (using
12 # file:// protocol) or streaming files over an accepted protocol.
13 #
14 music_directory         "~/media/audio"
15 #
16 # This setting sets the MPD internal playlist directory. The purpose of this
17 # directory is storage for playlists created by MPD. The server will use 
18 # playlist files not created by the server but only if they are in the MPD
19 # format. This setting defaults to playlist saving being disabled.
20 #
21 playlist_directory              "~/var/mpd/playlists"
22 #
23 # This setting sets the location of the MPD database. This file is used to
24 # load the database at server start up and store the database while the 
25 # server is not up. This setting defaults to disabled which will allow
26 # MPD to accept files over ipc socket (using file:// protocol) or streaming
27 # files over an accepted protocol.
28 #
29 db_file                 "~/var/mpd/tag_cache"
30
31 # These settings are the locations for the daemon log files for the daemon.
32 # These logs are great for troubleshooting, depending on your log_level
33 # settings.
34 #
35 # The special value "syslog" makes MPD use the local syslog daemon. This
36 # setting defaults to logging to syslog, otherwise logging is disabled.
37 #
38 log_file                        "~/var/mpd/mpd.log"
39 #
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
42 # default and the pid file will not be stored.
43 #
44 pid_file                        "~/var/mpd/pid"
45 #
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 and the server 
49 # state will be reset on server start up.
50 #
51 state_file                      "~/var/mpd/state"
52 #
53 # The location of the sticker database.  This is a database which
54 # manages dynamic information attached to songs.
55 #
56 sticker_file                   "~/var/mpd/sticker.sql"
57 #
58 ###############################################################################
59
60
61 # General music daemon options ################################################
62 #
63 # This setting specifies the user that MPD will run as. MPD should never run as
64 # root and you may use this setting to make MPD change its user ID after
65 # initialization. This setting is disabled by default and MPD is run as the
66 # current user.
67 #
68 #user                           "mpd"
69 #
70 # This setting specifies the group that MPD will run as. If not specified
71 # primary group of user specified with "user" setting will be used (if set).
72 # This is useful if MPD needs to be a member of group such as "audio" to
73 # have permission to use sound card.
74 #
75 #group                          "nogroup"
76 #
77 # This setting sets the address for the daemon to listen on. Careful attention
78 # should be paid if this is assigned to anything other then the default, any.
79 # This setting can deny access to control of the daemon. Choose any if you want
80 # to have mpd listen on every address
81 #
82 # For network
83 #bind_to_address                "localhost"
84 #
85 # And for Unix Socket
86 bind_to_address         "~/var/mpd/socket"
87 #
88 # This setting is the TCP port that is desired for the daemon to get assigned
89 # to.
90 #
91 #port                           "6600"
92 #
93 # This setting controls the type of information which is logged. Available 
94 # setting arguments are "default", "secure" or "verbose". The "verbose" setting
95 # argument is recommended for troubleshooting, though can quickly stretch
96 # available resources on limited hardware storage.
97 #
98 #log_level                      "default"
99 #
100 # If you have a problem with your MP3s ending abruptly it is recommended that 
101 # you set this argument to "no" to attempt to fix the problem. If this solves
102 # the problem, it is highly recommended to fix the MP3 files with vbrfix
103 # (available as vbrfix in the debian archive), at which
104 # point gapless MP3 playback can be enabled.
105 #
106 #gapless_mp3_playback                   "yes"
107 #
108 # Setting "restore_paused" to "yes" puts MPD into pause mode instead
109 # of starting playback after startup.
110 #
111 restore_paused "yes"
112 #
113 # This setting enables MPD to create playlists in a format usable by other
114 # music players.
115 #
116 #save_absolute_paths_in_playlists       "no"
117 #
118 # This setting defines a list of tag types that will be extracted during the 
119 # audio file discovery process. The complete list of possible values can be
120 # found in the mpd.conf man page.
121 #metadata_to_use        "artist,album,title,track,name,genre,date,composer,performer,disc"
122 #
123 # This setting enables automatic update of MPD's database when files in 
124 # music_directory are changed.
125 #
126 #auto_update    "yes"
127 #
128 # Limit the depth of the directories being watched, 0 means only watch
129 # the music directory itself.  There is no limit by default.
130 #
131 #auto_update_depth "3"
132 #
133 ###############################################################################
134
135
136 # Symbolic link behavior ######################################################
137 #
138 # If this setting is set to "yes", MPD will discover audio files by following 
139 # symbolic links outside of the configured music_directory.
140 #
141 #follow_outside_symlinks        "yes"
142 #
143 # If this setting is set to "yes", MPD will discover audio files by following
144 # symbolic links inside of the configured music_directory.
145 #
146 #follow_inside_symlinks         "yes"
147 #
148 ###############################################################################
149
150
151 # Zeroconf / Avahi Service Discovery ##########################################
152 #
153 # If this setting is set to "yes", service information will be published with
154 # Zeroconf / Avahi.
155 #
156 #zeroconf_enabled               "yes"
157 #
158 # The argument to this setting will be the Zeroconf / Avahi unique name for
159 # this MPD server on the network.
160 #
161 #zeroconf_name                  "Music Player"
162 #
163 ###############################################################################
164
165
166 # Permissions #################################################################
167 #
168 # If this setting is set, MPD will require password authorization. The password
169 # can setting can be specified multiple times for different password profiles.
170 #
171 #password                        "password@read,add,control,admin"
172 #
173 # This setting specifies the permissions a user has who has not yet logged in. 
174 #
175 #default_permissions             "read,add,control,admin"
176 #
177 ###############################################################################
178
179
180 # Database #######################################################################
181 #
182
183 #database {
184 #       plugin "proxy"
185 #       host "other.mpd.host"
186 #       port "6600"
187 #}
188
189 # Input #######################################################################
190 #
191
192 input {
193         plugin "curl"
194 #       proxy "proxy.isp.com:8080"
195 #       proxy_user "user"
196 #       proxy_password "password"
197 }
198
199 #
200 ###############################################################################
201
202 # Audio Output ################################################################
203 #
204 # MPD supports various audio output types, as well as playing through multiple 
205 # audio outputs at the same time, through multiple audio_output settings 
206 # blocks. Setting this block is optional, though the server will only attempt
207 # autodetection for one sound card.
208 #
209 # An example of an ALSA output:
210 #
211 #audio_output {
212 #       type            "alsa"
213 #       name            "My ALSA Device"
214 #       device          "hw:0,0"        # optional
215 #       mixer_type      "hardware"      # optional
216 #       mixer_device    "default"       # optional
217 #       mixer_control   "PCM"           # optional
218 #       mixer_index     "0"             # optional
219 #}
220 #
221 # An example of an OSS output:
222 #
223 #audio_output {
224 #       type            "oss"
225 #       name            "My OSS Device"
226 #       device          "/dev/dsp"      # optional
227 #       mixer_type      "hardware"      # optional
228 #       mixer_device    "/dev/mixer"    # optional
229 #       mixer_control   "PCM"           # optional
230 #}
231 #
232 # An example of a shout output (for streaming to Icecast):
233 #
234 #audio_output {
235 #       type            "shout"
236 #       encoding        "ogg"                   # optional
237 #       name            "My Shout Stream"
238 #       host            "localhost"
239 #       port            "8000"
240 #       mount           "/mpd.ogg"
241 #       password        "hackme"
242 #       quality         "5.0"
243 #       bitrate         "128"
244 #       format          "44100:16:1"
245 #       protocol        "icecast2"              # optional
246 #       user            "source"                # optional
247 #       description     "My Stream Description" # optional
248 #       url             "http://example.com"    # optional
249 #       genre           "jazz"                  # optional
250 #       public          "no"                    # optional
251 #       timeout         "2"                     # optional
252 #       mixer_type      "software"              # optional
253 #}
254 #
255 # An example of a recorder output:
256 #
257 #audio_output {
258 #       type            "recorder"
259 #       name            "My recorder"
260 #       encoder         "vorbis"                # optional, vorbis or lame
261 #       path            "/var/lib/mpd/recorder/mpd.ogg"
262 ##      quality         "5.0"                   # do not define if bitrate is defined
263 #       bitrate         "128"                   # do not define if quality is defined
264 #       format          "44100:16:1"
265 #}
266 #
267 # An example of a httpd output (built-in HTTP streaming server):
268 #
269 #audio_output {
270 #       type            "httpd"
271 #       name            "My HTTP Stream"
272 #       encoder         "vorbis"                # optional, vorbis or lame
273 #       port            "8000"
274 #       bind_to_address "0.0.0.0"               # optional, IPv4 or IPv6
275 #       quality         "5.0"                   # do not define if bitrate is defined
276 #       bitrate         "128"                   # do not define if quality is defined
277 #       format          "44100:16:1"
278 #       max_clients     "0"                     # optional 0=no limit
279 #}
280 #
281 # An example of a pulseaudio output (streaming to a remote pulseaudio server)
282 # Please see README.Debian if you want mpd to play through the pulseaudio
283 # daemon started as part of your graphical desktop session!
284 #
285 audio_output {
286         type            "pulse"
287         name            "My Pulse Output"
288 #       server          "remote_server"         # optional
289 #       sink            "remote_server_sink"    # optional
290 }
291 #
292 # An example of a winmm output (Windows multimedia API).
293 #
294 #audio_output {
295 #       type            "winmm"
296 #       name            "My WinMM output"
297 #       device          "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional
298 #               or
299 #       device          "0"             # optional
300 #       mixer_type      "hardware"      # optional
301 #}
302 #
303 # An example of an openal output.
304 #
305 #audio_output {
306 #       type            "openal"
307 #       name            "My OpenAL output"
308 #       device          "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional
309 #}
310 #
311 ## Example "pipe" output:
312 #
313 #audio_output {
314 #       type            "pipe"
315 #       name            "my pipe"
316 #       command         "aplay -f cd 2>/dev/null"
317 ## Or if you're want to use AudioCompress
318 #       command         "AudioCompress -m | aplay -f cd 2>/dev/null"
319 ## Or to send raw PCM stream through PCM:
320 #       command         "nc example.org 8765"
321 #       format          "44100:16:2"
322 #}
323 #
324 ## An example of a null output (for no audio output):
325 #
326 #audio_output {
327 #       type            "null"
328 #       name            "My Null Output"
329 #       mixer_type      "none"                  # optional
330 #}
331 #
332 # If MPD has been compiled with libsamplerate support, this setting specifies 
333 # the sample rate converter to use.  Possible values can be found in the 
334 # mpd.conf man page or the libsamplerate documentation. By default, this is
335 # setting is disabled.
336 #
337 #samplerate_converter           "Fastest Sinc Interpolator"
338 #
339 ###############################################################################
340
341
342 # Normalization automatic volume adjustments ##################################
343 #
344 # This setting specifies the type of ReplayGain to use. This setting can have
345 # the argument "off", "album", "track" or "auto". "auto" is a special mode that
346 # chooses between "track" and "album" depending on the current state of
347 # random playback. If random playback is enabled then "track" mode is used.
348 # See <http://www.replaygain.org> for more details about ReplayGain.
349 # This setting is off by default.
350 #
351 #replaygain                     "album"
352 #
353 # This setting sets the pre-amp used for files that have ReplayGain tags. By
354 # default this setting is disabled.
355 #
356 #replaygain_preamp              "0"
357 #
358 # This setting sets the pre-amp used for files that do NOT have ReplayGain tags.
359 # By default this setting is disabled.
360 #
361 #replaygain_missing_preamp      "0"
362 #
363 # This setting enables or disables ReplayGain limiting.
364 # MPD calculates actual amplification based on the ReplayGain tags
365 # and replaygain_preamp / replaygain_missing_preamp setting.
366 # If replaygain_limit is enabled MPD will never amplify audio signal
367 # above its original level. If replaygain_limit is disabled such amplification
368 # might occur. By default this setting is enabled.
369 #
370 #replaygain_limit               "yes"
371 #
372 # This setting enables on-the-fly normalization volume adjustment. This will
373 # result in the volume of all playing audio to be adjusted so the output has 
374 # equal "loudness". This setting is disabled by default.
375 #
376 #volume_normalization           "no"
377 #
378 ###############################################################################
379
380
381 # Character Encoding ##########################################################
382 #
383 # If file or directory names do not display correctly for your locale then you 
384 # may need to modify this setting.
385 #
386 filesystem_charset              "UTF-8"
387 #
388 # This setting controls the encoding that ID3v1 tags should be converted from.
389 #
390 id3v1_encoding                  "UTF-8"
391 #
392 ###############################################################################
393
394
395 # SIDPlay decoder #############################################################
396 #
397 # songlength_database:
398 #  Location of your songlengths file, as distributed with the HVSC.
399 #  The sidplay plugin checks this for matching MD5 fingerprints.
400 #  See http://www.c64.org/HVSC/DOCUMENTS/Songlengths.faq
401 #
402 # default_songlength:
403 #  This is the default playing time in seconds for songs not in the
404 #  songlength database, or in case you're not using a database.
405 #  A value of 0 means play indefinitely.
406 #
407 # filter:
408 #  Turns the SID filter emulation on or off.
409 #
410 #decoder {
411 #       plugin                  "sidplay"
412 #       songlength_database     "/media/C64Music/DOCUMENTS/Songlengths.txt"
413 #       default_songlength      "120"
414 #       filter "true"
415 #}
416 #
417 ###############################################################################
418