mpd.conf

   1 # Base configuration file for MPD on PLD-linux
   2 #
   3 # Based on the example configuration file for MPD
   4 # See the mpd.conf man page for a more detailed description of each parameter.
   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         "/music"
  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/lib/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/lib/mpd/mpd.db"
  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/log/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/run/mpd/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/lib/mpd/mpdstate"
  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/lib/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.
  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 # This setting enables MPD to create playlists in a format usable by other
 108 # music players.
 109 #
 110 #save_absolute_paths_in_playlists       "no"
 111 #
 112 # This setting defines a list of tag types that will be extracted during the
 113 # audio file discovery process. Optionally, 'comment' can be added to this
 114 # list.
 115 #
 116 #metadata_to_use        "artist,album,title,track,name,genre,date,composer,performer,disc"
 117 #
 118 # This setting enables automatic update of MPD's database when files in
 119 # music_directory are changed.
 120 #
 121 #auto_update    "yes"
 122 #
 123 # Limit the depth of the directories being watched, 0 means only watch
 124 # the music directory itself.  There is no limit by default.
 125 #
 126 #auto_update_depth "3"
 127 #
 128 ###############################################################################
 129
 130
 131 # Symbolic link behavior ######################################################
 132 #
 133 # If this setting is set to "yes", MPD will discover audio files by following
 134 # symbolic links outside of the configured music_directory.
 135 #
 136 #follow_outside_symlinks        "yes"
 137 #
 138 # If this setting is set to "yes", MPD will discover audio files by following
 139 # symbolic links inside of the configured music_directory.
 140 #
 141 #follow_inside_symlinks         "yes"
 142 #
 143 ###############################################################################
 144
 145
 146 # Zeroconf / Avahi Service Discovery ##########################################
 147 #
 148 # If this setting is set to "yes", service information will be published with
 149 # Zeroconf / Avahi.
 150 #
 151 #zeroconf_enabled               "yes"
 152 #
 153 # The argument to this setting will be the Zeroconf / Avahi unique name for
 154 # this MPD server on the network.
 155 #
 156 #zeroconf_name                  "Music Player"
 157 #
 158 ###############################################################################
 159
 160
 161 # Permissions #################################################################
 162 #
 163 # If this setting is set, MPD will require password authorization. The password
 164 # can setting can be specified multiple times for different password profiles.
 165 #
 166 #password                        "password@read,add,control,admin"
 167 #
 168 # This setting specifies the permissions a user has who has not yet logged in.
 169 #
 170 #default_permissions             "read,add,control,admin"
 171 #
 172 ###############################################################################
 173
 174
 175 # Input #######################################################################
 176 #
 177
 178 input {
 179         plugin "curl"
 180 #       proxy "proxy.isp.com:8080"
 181 #       proxy_user "user"
 182 #       proxy_password "password"
 183 }
 184
 185 #
 186 ###############################################################################
 187
 188 # Audio Output ################################################################
 189 #
 190 # MPD supports various audio output types, as well as playing through multiple
 191 # audio outputs at the same time, through multiple audio_output settings
 192 # blocks. Setting this block is optional, though the server will only attempt
 193 # autodetection for one sound card.
 194 #
 195 # See <http://mpd.wikia.com/wiki/Configuration#Audio_Outputs> for examples of
 196 # other audio outputs.
 197 #
 198 # An example of an ALSA output:
 199 #
 200 audio_output {
 201         type            "alsa"
 202         name            "My ALSA Device"
 203 ##      device          "hw:0,0"        # optional
 204 ##      format          "44100:16:2"    # optional
 205 ##      mixer_type      "hardware"      # optional
 206 ##      mixer_device    "default"       # optional
 207 ##      mixer_control   "PCM"           # optional
 208 ##      mixer_index     "0"             # optional
 209 }
 210 #
 211 # An example of an OSS output:
 212 #
 213 #audio_output {
 214 #       type            "oss"
 215 #       name            "My OSS Device"
 216 ##      device          "/dev/dsp"      # optional
 217 ##      format          "44100:16:2"    # optional
 218 ##      mixer_type      "hardware"      # optional
 219 ##      mixer_device    "/dev/mixer"    # optional
 220 ##      mixer_control   "PCM"           # optional
 221 #}
 222 #
 223 # An example of a shout output (for streaming to Icecast):
 224 #
 225 #audio_output {
 226 #       type            "shout"
 227 #       encoding        "ogg"                   # optional
 228 #       name            "My Shout Stream"
 229 #       host            "localhost"
 230 #       port            "8000"
 231 #       mount           "/mpd.ogg"
 232 #       password        "hackme"
 233 #       quality         "5.0"
 234 #       bitrate         "128"
 235 #       format          "44100:16:1"
 236 ##      protocol        "icecast2"              # optional
 237 ##      user            "source"                # optional
 238 ##      description     "My Stream Description" # optional
 239 ##      genre           "jazz"                  # optional
 240 ##      public          "no"                    # optional
 241 ##      timeout         "2"                     # optional
 242 ##      mixer_type      "software"              # optional
 243 #}
 244 #
 245 # An example of a recorder output:
 246 #
 247 #audio_output {
 248 #       type            "recorder"
 249 #       name            "My recorder"
 250 #       encoder         "vorbis"                # optional, vorbis or lame
 251 #       path            "/var/lib/mpd/recorder/mpd.ogg"
 252 ##      quality         "5.0"                   # do not define if bitrate is defined
 253 #       bitrate         "128"                   # do not define if quality is defined
 254 #       format          "44100:16:1"
 255 #}
 256 #
 257 # An example of a httpd output (built-in HTTP streaming server):
 258 #
 259 #audio_output {
 260 #       type            "httpd"
 261 #       name            "My HTTP Stream"
 262 #       encoder         "vorbis"                # optional, vorbis or lame
 263 #       port            "8000"
 264 #       bind_to_address "0.0.0.0"               # optional, IPv4 or IPv6
 265 ##      quality         "5.0"                   # do not define if bitrate is defined
 266 #       bitrate         "128"                   # do not define if quality is defined
 267 #       format          "44100:16:1"
 268 #       max_clients     "0"                     # optional 0=no limit
 269 #}
 270 #
 271 # An example of a pulseaudio output (streaming to a remote pulseaudio server)
 272 #
 273 #audio_output {
 274 #       type            "pulse"
 275 #       name            "My Pulse Output"
 276 ##      server          "remote_server"         # optional
 277 ##      sink            "remote_server_sink"    # optional
 278 #}
 279 #
 280 ## Example "pipe" output:
 281 #
 282 #audio_output {
 283 #       type            "pipe"
 284 #       name            "my pipe"
 285 #       command         "aplay -f cd 2>/dev/null"
 286 ## Or if you're want to use AudioCompress
 287 #       command         "AudioCompress -m | aplay -f cd 2>/dev/null"
 288 ## Or to send raw PCM stream through PCM:
 289 #       command         "nc example.org 8765"
 290 #       format          "44100:16:2"
 291 #}
 292 #
 293 ## An example of a null output (for no audio output):
 294 #
 295 #audio_output {
 296 #       type            "null"
 297 #       name            "My Null Output"
 298 #       mixer_type      "none"                  # optional
 299 #}
 300 #
 301 # This setting will change all decoded audio to be converted to the specified
 302 # format before being passed to the audio outputs. By default, this setting is
 303 # disabled.
 304 #
 305 #audio_output_format            "44100:16:2"
 306 #
 307 # If MPD has been compiled with libsamplerate support, this setting specifies
 308 # the sample rate converter to use.  Possible values can be found in the
 309 # mpd.conf man page or the libsamplerate documentation. By default, this is
 310 # setting is disabled.
 311 #
 312 #samplerate_converter           "Fastest Sinc Interpolator"
 313 #
 314 ###############################################################################
 315
 316
 317 # Normalization automatic volume adjustments ##################################
 318 #
 319 # This setting specifies the type of ReplayGain to use. This setting can have
 320 # the argument "off", "album" or "track". See <http://www.replaygain.org>
 321 # for more details. This setting is off by default.
 322 #
 323 #replaygain                     "album"
 324 #
 325 # This setting sets the pre-amp used for files that have ReplayGain tags. By
 326 # default this setting is disabled.
 327 #
 328 #replaygain_preamp              "0"
 329 #
 330 # This setting enables on-the-fly normalization volume adjustment. This will
 331 # result in the volume of all playing audio to be adjusted so the output has
 332 # equal "loudness". This setting is disabled by default.
 333 #
 334 #volume_normalization           "no"
 335 #
 336 ###############################################################################
 337
 338
 339 # MPD Internal Buffering ######################################################
 340 #
 341 # This setting adjusts the size of internal decoded audio buffering. Changing
 342 # this may have undesired effects. Don't change this if you don't know what you
 343 # are doing.
 344 #
 345 #audio_buffer_size              "2048"
 346 #
 347 # This setting controls the percentage of the buffer which is filled before
 348 # beginning to play. Increasing this reduces the chance of audio file skipping,
 349 # at the cost of increased time prior to audio playback.
 350 #
 351 #buffer_before_play             "10%"
 352 #
 353 ###############################################################################
 354
 355
 356 # Resource Limitations ########################################################
 357 #
 358 # These settings are various limitations to prevent MPD from using too many
 359 # resources. Generally, these settings should be minimized to prevent security
 360 # risks, depending on the operating resources.
 361 #
 362 #connection_timeout             "60"
 363 #max_connections                "10"
 364 #max_playlist_length            "16384"
 365 #max_command_list_size          "2048"
 366 #max_output_buffer_size         "8192"
 367 #
 368 ###############################################################################
 369
 370
 371 # Character Encoding ##########################################################
 372 #
 373 # If file or directory names do not display correctly for your locale then you
 374 # may need to modify this setting.
 375 #
 376 filesystem_charset              "UTF-8"
 377 #
 378 # This setting controls the encoding that ID3v1 tags should be converted from.
 379 #
 380 #id3v1_encoding                 "ISO-8859-1"
 381 #
 382 ###############################################################################
 383
 384
 385 # SIDPlay decoder #############################################################
 386 #
 387 # songlength_database:
 388 #  Location of your songlengths file, as distributed with the HVSC.
 389 #  The sidplay plugin checks this for matching MD5 fingerprints.
 390 #  See http://www.c64.org/HVSC/DOCUMENTS/Songlengths.faq
 391 #
 392 # default_songlength:
 393 #  This is the default playing time in seconds for songs not in the
 394 #  songlength database, or in case you're not using a database.
 395 #  A value of 0 means play indefinitely.
 396 #
 397 # filter:
 398 #  Turns the SID filter emulation on or off.
 399 #
 400 #decoder {
 401 #       plugin                  "sidplay"
 402 #       songlength_database     "/media/C64Music/DOCUMENTS/Songlengths.txt"
 403 #       default_songlength      "120"
 404 #       filter "true"
 405 #}
 406 #
 407 ###############################################################################
 408