dotfiles

Unnamed repository; edit this file 'description' to name the repository.
Log | Files | Refs | README | LICENSE

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 ###############################################################################