mpd.conf

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