dotfiles

Configs for programs I use!
git clone git://shipwreckt.co.uk/dotfiles.git
Log | Files | Refs | README | LICENSE

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