mpdconf.example (13281B)
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 "~/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 "~/.config/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 "~/.config/mpd/database" 29 30 # These settings are the locations for the daemon log files for the daemon. 31 # 32 # The special value "syslog" makes MPD use the local syslog daemon. This 33 # setting defaults to logging to syslog. 34 # 35 # If you use systemd, do not configure a log_file. With systemd, MPD 36 # defaults to the systemd journal, which is fine. 37 # 38 log_file "~/.config/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 # If you use systemd, do not configure a pid_file. 45 # 46 pid_file "~/.config/mpd/pid" 47 48 # This setting sets the location of the file which contains information about 49 # most variables to get MPD back into the same general shape it was in before 50 # it was brought down. This setting is disabled by default and the server 51 # state will be reset on server start up. 52 # 53 state_file "~/.config/mpd/state" 54 55 # 56 # The location of the sticker database. This is a database which 57 # manages dynamic information attached to songs. 58 # 59 #sticker_file "~/.mpd/sticker.sql" 60 # 61 ############################################################################### 62 63 64 # General music daemon options ################################################ 65 # 66 # This setting specifies the user that MPD will run as. MPD should never run as 67 # root and you may use this setting to make MPD change its user ID after 68 # initialization. This setting is disabled by default and MPD is run as the 69 # current user. 70 # 71 #user "nobody" 72 # 73 # This setting specifies the group that MPD will run as. If not specified 74 # primary group of user specified with "user" setting will be used (if set). 75 # This is useful if MPD needs to be a member of group such as "audio" to 76 # have permission to use sound card. 77 # 78 #group "nogroup" 79 # 80 # This setting sets the address for the daemon to listen on. Careful attention 81 # should be paid if this is assigned to anything other than the default, any. 82 # This setting can deny access to control of the daemon. Not effective if 83 # systemd socket activation is in use. 84 # 85 # For network 86 #bind_to_address "any" 87 # 88 # And for Unix Socket 89 #bind_to_address "~/.mpd/socket" 90 # 91 # This setting is the TCP port that is desired for the daemon to get assigned 92 # to. 93 # 94 #port "6600" 95 # 96 # Suppress all messages below the given threshold. Use "verbose" for 97 # troubleshooting. Available setting arguments are "notice", "info", "verbose", 98 # "warning" and "error". 99 # 100 #log_level "notice" 101 # 102 # Setting "restore_paused" to "yes" puts MPD into pause mode instead 103 # of starting playback after startup. 104 # 105 #restore_paused "no" 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. The complete list of possible values can be 114 # found in the user manual. 115 #metadata_to_use "artist,album,title,track,name,genre,date,composer,performer,disc" 116 # 117 # This example just enables the "comment" tag without disabling all 118 # the other supported tags: 119 #metadata_to_use "+comment" 120 # 121 # This setting enables automatic update of MPD's database when files in 122 # music_directory are changed. 123 # 124 #auto_update "yes" 125 # 126 # Limit the depth of the directories being watched, 0 means only watch 127 # the music directory itself. There is no limit by default. 128 # 129 #auto_update_depth "3" 130 # 131 ############################################################################### 132 133 134 # Symbolic link behavior ###################################################### 135 # 136 # If this setting is set to "yes", MPD will discover audio files by following 137 # symbolic links outside of the configured music_directory. 138 # 139 #follow_outside_symlinks "yes" 140 # 141 # If this setting is set to "yes", MPD will discover audio files by following 142 # symbolic links inside of the configured music_directory. 143 # 144 #follow_inside_symlinks "yes" 145 # 146 ############################################################################### 147 148 149 # Zeroconf / Avahi Service Discovery ########################################## 150 # 151 # If this setting is set to "yes", service information will be published with 152 # Zeroconf / Avahi. 153 # 154 #zeroconf_enabled "yes" 155 # 156 # The argument to this setting will be the Zeroconf / Avahi unique name for 157 # this MPD server on the network. %h will be replaced with the hostname. 158 # 159 #zeroconf_name "Music Player @ %h" 160 # 161 ############################################################################### 162 163 164 # Permissions ################################################################# 165 # 166 # If this setting is set, MPD will require password authorization. The password 167 # setting can be specified multiple times for different password profiles. 168 # 169 #password "password@read,add,control,admin" 170 # 171 # This setting specifies the permissions a user has who has not yet logged in. 172 # 173 #default_permissions "read,add,control,admin" 174 # 175 ############################################################################### 176 177 178 # Database ####################################################################### 179 # 180 # An example of a database section instead of the old 'db_file' setting. 181 # It enables mounting other storages into the music directory. 182 # 183 #database { 184 # plugin "simple" 185 # path "~/.local/share/mpd/db" 186 # cache_directory "~/.local/share/mpd/cache" 187 #} 188 # 189 # An example of database config for a satellite setup 190 # 191 #music_directory "nfs://fileserver.local/srv/mp3" 192 #database { 193 # plugin "proxy" 194 # host "other.mpd.host" 195 # port "6600" 196 #} 197 198 # Input ####################################################################### 199 # 200 input { 201 plugin "curl" 202 # proxy "proxy.isp.com:8080" 203 # proxy_user "user" 204 # proxy_password "password" 205 } 206 207 # 208 ############################################################################### 209 210 # Audio Output ################################################################ 211 # 212 # MPD supports various audio output types, as well as playing through multiple 213 # audio outputs at the same time, through multiple audio_output settings 214 # blocks. Setting this block is optional, though the server will only attempt 215 # autodetection for one sound card. 216 # 217 # An example of an ALSA output: 218 # 219 #audio_output { 220 # type "alsa" 221 # name "My ALSA Device" 222 ## device "hw:0,0" # optional 223 ## mixer_type "hardware" # optional 224 ## mixer_device "default" # optional 225 ## mixer_control "PCM" # optional 226 ## mixer_index "0" # optional 227 #} 228 # 229 # An example of an OSS output: 230 # 231 #audio_output { 232 # type "oss" 233 # name "My OSS Device" 234 ## device "/dev/dsp" # optional 235 ## mixer_type "hardware" # optional 236 ## mixer_device "/dev/mixer" # optional 237 ## mixer_control "PCM" # optional 238 #} 239 # 240 # An example of a shout output (for streaming to Icecast): 241 # 242 #audio_output { 243 # type "shout" 244 # encoder "vorbis" # optional 245 # name "My Shout Stream" 246 # host "localhost" 247 # port "8000" 248 # mount "/mpd.ogg" 249 # password "hackme" 250 # quality "5.0" 251 # bitrate "128" 252 # format "44100:16:1" 253 ## protocol "icecast2" # optional 254 ## user "source" # optional 255 ## description "My Stream Description" # optional 256 ## url "http://example.com" # optional 257 ## genre "jazz" # optional 258 ## public "no" # optional 259 ## timeout "2" # optional 260 ## mixer_type "software" # optional 261 #} 262 # 263 # An example of a recorder output: 264 # 265 #audio_output { 266 # type "recorder" 267 # name "My recorder" 268 # encoder "vorbis" # optional, vorbis or lame 269 # path "/var/lib/mpd/recorder/mpd.ogg" 270 ## quality "5.0" # do not define if bitrate is defined 271 # bitrate "128" # do not define if quality is defined 272 # format "44100:16:1" 273 #} 274 # 275 # An example of a httpd output (built-in HTTP streaming server): 276 # 277 #audio_output { 278 # type "httpd" 279 # name "My HTTP Stream" 280 # encoder "vorbis" # optional, vorbis or lame 281 # port "8000" 282 # bind_to_address "0.0.0.0" # optional, IPv4 or IPv6 283 ## quality "5.0" # do not define if bitrate is defined 284 # bitrate "128" # do not define if quality is defined 285 # format "44100:16:1" 286 # max_clients "0" # optional 0=no limit 287 #} 288 # 289 # An example of a pulseaudio output (streaming to a remote pulseaudio server) 290 # 291 audio_output { 292 type "pulse" 293 name "My Pulse Output" 294 ## server "remote_server" # optional 295 ## sink "remote_server_sink" # optional 296 ## media_role "media_role" #optional 297 } 298 299 # 300 # An example of a winmm output (Windows multimedia API). 301 # 302 #audio_output { 303 # type "winmm" 304 # name "My WinMM output" 305 ## device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional 306 # or 307 ## device "0" # optional 308 ## mixer_type "hardware" # optional 309 #} 310 # 311 # An example of a wasapi output (Windows multimedia API). 312 # 313 #audio_output { 314 # type "wasapi" 315 # name "My WASAPI output" 316 ## device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional 317 # or 318 ## device "0" # optional 319 ## mixer_type "hardware" # optional 320 ## Exclusive mode blocks all other audio source, and get best audio quality without resampling. 321 ## exclusive "no" # optional 322 ## Enumerate all devices in log. 323 ## enumerate "no" # optional 324 #} 325 # 326 # An example of an openal output. 327 # 328 #audio_output { 329 # type "openal" 330 # name "My OpenAL output" 331 ## device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional 332 #} 333 # 334 # An example of an sndio output. 335 # 336 #audio_output { 337 # type "sndio" 338 # name "sndio output" 339 # mixer_type "hardware" 340 #} 341 # 342 # An example of an OS X output: 343 # 344 #audio_output { 345 # type "osx" 346 # name "My OS X Device" 347 ## device "Built-in Output" # optional 348 ## channel_map "-1,-1,0,1" # optional 349 #} 350 # 351 ## Example "pipe" output: 352 # 353 #audio_output { 354 # type "pipe" 355 # name "my pipe" 356 # command "aplay -f cd 2>/dev/null" 357 ## Or if you're want to use AudioCompress 358 # command "AudioCompress -m | aplay -f cd 2>/dev/null" 359 ## Or to send raw PCM stream through PCM: 360 # command "nc example.org 8765" 361 # format "44100:16:2" 362 #} 363 # 364 ## An example of a null output (for no audio output): 365 # 366 #audio_output { 367 # type "null" 368 # name "My Null Output" 369 # mixer_type "none" # optional 370 #} 371 # 372 ############################################################################### 373 374 375 # Normalization automatic volume adjustments ################################## 376 # 377 # This setting specifies the type of ReplayGain to use. This setting can have 378 # the argument "off", "album", "track" or "auto". "auto" is a special mode that 379 # chooses between "track" and "album" depending on the current state of 380 # random playback. If random playback is enabled then "track" mode is used. 381 # See <https://wiki.hydrogenaud.io/index.php?title=Replaygain> for 382 # more details about ReplayGain. 383 # This setting is off by default. 384 # 385 #replaygain "album" 386 # 387 # This setting sets the pre-amp used for files that have ReplayGain tags. By 388 # default this setting is disabled. 389 # 390 #replaygain_preamp "0" 391 # 392 # This setting sets the pre-amp used for files that do NOT have ReplayGain tags. 393 # By default this setting is disabled. 394 # 395 #replaygain_missing_preamp "0" 396 # 397 # This setting enables or disables ReplayGain limiting. 398 # MPD calculates actual amplification based on the ReplayGain tags 399 # and replaygain_preamp / replaygain_missing_preamp setting. 400 # If replaygain_limit is enabled MPD will never amplify audio signal 401 # above its original level. If replaygain_limit is disabled such amplification 402 # might occur. By default this setting is enabled. 403 # 404 #replaygain_limit "yes" 405 # 406 # This setting enables on-the-fly normalization volume adjustment. This will 407 # result in the volume of all playing audio to be adjusted so the output has 408 # equal "loudness". This setting is disabled by default. 409 # 410 #volume_normalization "no" 411 # 412 ############################################################################### 413 414 # Character Encoding ########################################################## 415 # 416 # If file or directory names do not display correctly for your locale then you 417 # may need to modify this setting. 418 # 419 #filesystem_charset "UTF-8" 420 # 421 ###############################################################################