mpdconf.example (13336B)
1 # An example configuration file for MPD. 2 # Read the user manual for documentation: http://www.musicpd.org/doc/user/ 3 4 # Note from Shipwreckt: 5 # Left this here just in case. 6 7 # Files and directories ####################################################### 8 # 9 # This setting controls the top directory which MPD will search to discover the 10 # available audio files and add them to the daemon's online database. This 11 # setting defaults to the XDG directory, otherwise the music directory will be 12 # be disabled and audio files will only be accepted over ipc socket (using 13 # file:// protocol) or streaming files over an accepted protocol. 14 # 15 music_directory "~/Music" 16 # 17 # This setting sets the MPD internal playlist directory. The purpose of this 18 # directory is storage for playlists created by MPD. The server will use 19 # playlist files not created by the server but only if they are in the MPD 20 # format. This setting defaults to playlist saving being disabled. 21 # 22 playlist_directory "~/.config/mpd/playlists" 23 # 24 # This setting sets the location of the MPD database. This file is used to 25 # load the database at server start up and store the database while the 26 # server is not up. This setting defaults to disabled which will allow 27 # MPD to accept files over ipc socket (using file:// protocol) or streaming 28 # files over an accepted protocol. 29 # 30 db_file "~/.config/mpd/database" 31 32 # These settings are the locations for the daemon log files for the daemon. 33 # 34 # The special value "syslog" makes MPD use the local syslog daemon. This 35 # setting defaults to logging to syslog. 36 # 37 # If you use systemd, do not configure a log_file. With systemd, MPD 38 # defaults to the systemd journal, which is fine. 39 # 40 log_file "~/.config/mpd/mpd.log" 41 42 # This setting sets the location of the file which stores the process ID 43 # for use of mpd --kill and some init scripts. This setting is disabled by 44 # default and the pid file will not be stored. 45 # 46 # If you use systemd, do not configure a pid_file. 47 # 48 pid_file "~/.config/mpd/pid" 49 50 # This setting sets the location of the file which contains information about 51 # most variables to get MPD back into the same general shape it was in before 52 # it was brought down. This setting is disabled by default and the server 53 # state will be reset on server start up. 54 # 55 state_file "~/.config/mpd/state" 56 57 # 58 # The location of the sticker database. This is a database which 59 # manages dynamic information attached to songs. 60 # 61 #sticker_file "~/.mpd/sticker.sql" 62 # 63 ############################################################################### 64 65 66 # General music daemon options ################################################ 67 # 68 # This setting specifies the user that MPD will run as. MPD should never run as 69 # root and you may use this setting to make MPD change its user ID after 70 # initialization. This setting is disabled by default and MPD is run as the 71 # current user. 72 # 73 #user "nobody" 74 # 75 # This setting specifies the group that MPD will run as. If not specified 76 # primary group of user specified with "user" setting will be used (if set). 77 # This is useful if MPD needs to be a member of group such as "audio" to 78 # have permission to use sound card. 79 # 80 #group "nogroup" 81 # 82 # This setting sets the address for the daemon to listen on. Careful attention 83 # should be paid if this is assigned to anything other than the default, any. 84 # This setting can deny access to control of the daemon. Not effective if 85 # systemd socket activation is in use. 86 # 87 # For network 88 #bind_to_address "any" 89 # 90 # And for Unix Socket 91 #bind_to_address "~/.mpd/socket" 92 # 93 # This setting is the TCP port that is desired for the daemon to get assigned 94 # to. 95 # 96 #port "6600" 97 # 98 # Suppress all messages below the given threshold. Use "verbose" for 99 # troubleshooting. Available setting arguments are "notice", "info", "verbose", 100 # "warning" and "error". 101 # 102 #log_level "notice" 103 # 104 # Setting "restore_paused" to "yes" puts MPD into pause mode instead 105 # of starting playback after startup. 106 # 107 #restore_paused "no" 108 # 109 # This setting enables MPD to create playlists in a format usable by other 110 # music players. 111 # 112 #save_absolute_paths_in_playlists "no" 113 # 114 # This setting defines a list of tag types that will be extracted during the 115 # audio file discovery process. The complete list of possible values can be 116 # found in the user manual. 117 #metadata_to_use "artist,album,title,track,name,genre,date,composer,performer,disc" 118 # 119 # This example just enables the "comment" tag without disabling all 120 # the other supported tags: 121 #metadata_to_use "+comment" 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. %h will be replaced with the hostname. 160 # 161 #zeroconf_name "Music Player @ %h" 162 # 163 ############################################################################### 164 165 166 # Permissions ################################################################# 167 # 168 # If this setting is set, MPD will require password authorization. The password 169 # 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 # An example of a database section instead of the old 'db_file' setting. 183 # It enables mounting other storages into the music directory. 184 # 185 #database { 186 # plugin "simple" 187 # path "~/.local/share/mpd/db" 188 # cache_directory "~/.local/share/mpd/cache" 189 #} 190 # 191 # An example of database config for a satellite setup 192 # 193 #music_directory "nfs://fileserver.local/srv/mp3" 194 #database { 195 # plugin "proxy" 196 # host "other.mpd.host" 197 # port "6600" 198 #} 199 200 # Input ####################################################################### 201 # 202 input { 203 plugin "curl" 204 # proxy "proxy.isp.com:8080" 205 # proxy_user "user" 206 # proxy_password "password" 207 } 208 209 # 210 ############################################################################### 211 212 # Audio Output ################################################################ 213 # 214 # MPD supports various audio output types, as well as playing through multiple 215 # audio outputs at the same time, through multiple audio_output settings 216 # blocks. Setting this block is optional, though the server will only attempt 217 # autodetection for one sound card. 218 # 219 # An example of an ALSA output: 220 # 221 #audio_output { 222 # type "alsa" 223 # name "My ALSA Device" 224 ## device "hw:0,0" # optional 225 ## mixer_type "hardware" # optional 226 ## mixer_device "default" # optional 227 ## mixer_control "PCM" # optional 228 ## mixer_index "0" # optional 229 #} 230 # 231 # An example of an OSS output: 232 # 233 #audio_output { 234 # type "oss" 235 # name "My OSS Device" 236 ## device "/dev/dsp" # optional 237 ## mixer_type "hardware" # optional 238 ## mixer_device "/dev/mixer" # optional 239 ## mixer_control "PCM" # optional 240 #} 241 # 242 # An example of a shout output (for streaming to Icecast): 243 # 244 #audio_output { 245 # type "shout" 246 # encoder "vorbis" # optional 247 # name "My Shout Stream" 248 # host "localhost" 249 # port "8000" 250 # mount "/mpd.ogg" 251 # password "hackme" 252 # quality "5.0" 253 # bitrate "128" 254 # format "44100:16:1" 255 ## protocol "icecast2" # optional 256 ## user "source" # optional 257 ## description "My Stream Description" # optional 258 ## url "http://example.com" # optional 259 ## genre "jazz" # optional 260 ## public "no" # optional 261 ## timeout "2" # optional 262 ## mixer_type "software" # optional 263 #} 264 # 265 # An example of a recorder output: 266 # 267 #audio_output { 268 # type "recorder" 269 # name "My recorder" 270 # encoder "vorbis" # optional, vorbis or lame 271 # path "/var/lib/mpd/recorder/mpd.ogg" 272 ## quality "5.0" # do not define if bitrate is defined 273 # bitrate "128" # do not define if quality is defined 274 # format "44100:16:1" 275 #} 276 # 277 # An example of a httpd output (built-in HTTP streaming server): 278 # 279 #audio_output { 280 # type "httpd" 281 # name "My HTTP Stream" 282 # encoder "vorbis" # optional, vorbis or lame 283 # port "8000" 284 # bind_to_address "0.0.0.0" # optional, IPv4 or IPv6 285 ## quality "5.0" # do not define if bitrate is defined 286 # bitrate "128" # do not define if quality is defined 287 # format "44100:16:1" 288 # max_clients "0" # optional 0=no limit 289 #} 290 # 291 # An example of a pulseaudio output (streaming to a remote pulseaudio server) 292 # 293 audio_output { 294 type "pulse" 295 name "My Pulse Output" 296 ## server "remote_server" # optional 297 ## sink "remote_server_sink" # optional 298 ## media_role "media_role" #optional 299 } 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 a wasapi output (Windows multimedia API). 314 # 315 #audio_output { 316 # type "wasapi" 317 # name "My WASAPI output" 318 ## device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional 319 # or 320 ## device "0" # optional 321 ## mixer_type "hardware" # optional 322 ## Exclusive mode blocks all other audio source, and get best audio quality without resampling. 323 ## exclusive "no" # optional 324 ## Enumerate all devices in log. 325 ## enumerate "no" # optional 326 #} 327 # 328 # An example of an openal output. 329 # 330 #audio_output { 331 # type "openal" 332 # name "My OpenAL output" 333 ## device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional 334 #} 335 # 336 # An example of an sndio output. 337 # 338 #audio_output { 339 # type "sndio" 340 # name "sndio output" 341 # mixer_type "hardware" 342 #} 343 # 344 # An example of an OS X output: 345 # 346 #audio_output { 347 # type "osx" 348 # name "My OS X Device" 349 ## device "Built-in Output" # optional 350 ## channel_map "-1,-1,0,1" # optional 351 #} 352 # 353 ## Example "pipe" output: 354 # 355 #audio_output { 356 # type "pipe" 357 # name "my pipe" 358 # command "aplay -f cd 2>/dev/null" 359 ## Or if you're want to use AudioCompress 360 # command "AudioCompress -m | aplay -f cd 2>/dev/null" 361 ## Or to send raw PCM stream through PCM: 362 # command "nc example.org 8765" 363 # format "44100:16:2" 364 #} 365 # 366 ## An example of a null output (for no audio output): 367 # 368 #audio_output { 369 # type "null" 370 # name "My Null Output" 371 # mixer_type "none" # optional 372 #} 373 # 374 ############################################################################### 375 376 377 # Normalization automatic volume adjustments ################################## 378 # 379 # This setting specifies the type of ReplayGain to use. This setting can have 380 # the argument "off", "album", "track" or "auto". "auto" is a special mode that 381 # chooses between "track" and "album" depending on the current state of 382 # random playback. If random playback is enabled then "track" mode is used. 383 # See <https://wiki.hydrogenaud.io/index.php?title=Replaygain> for 384 # more details about ReplayGain. 385 # This setting is off by default. 386 # 387 #replaygain "album" 388 # 389 # This setting sets the pre-amp used for files that have ReplayGain tags. By 390 # default this setting is disabled. 391 # 392 #replaygain_preamp "0" 393 # 394 # This setting sets the pre-amp used for files that do NOT have ReplayGain tags. 395 # By default this setting is disabled. 396 # 397 #replaygain_missing_preamp "0" 398 # 399 # This setting enables or disables ReplayGain limiting. 400 # MPD calculates actual amplification based on the ReplayGain tags 401 # and replaygain_preamp / replaygain_missing_preamp setting. 402 # If replaygain_limit is enabled MPD will never amplify audio signal 403 # above its original level. If replaygain_limit is disabled such amplification 404 # might occur. By default this setting is enabled. 405 # 406 #replaygain_limit "yes" 407 # 408 # This setting enables on-the-fly normalization volume adjustment. This will 409 # result in the volume of all playing audio to be adjusted so the output has 410 # equal "loudness". This setting is disabled by default. 411 # 412 #volume_normalization "no" 413 # 414 ############################################################################### 415 416 # Character Encoding ########################################################## 417 # 418 # If file or directory names do not display correctly for your locale then you 419 # may need to modify this setting. 420 # 421 #filesystem_charset "UTF-8" 422 # 423 ###############################################################################