[~bandali/configs] / .config / mpd / mpd.conf

# An example configuration file for MPD.
# Read the user manual for documentation: http://www.musicpd.org/doc/user/


# Files and directories #######################################################
#
# This setting controls the top directory which MPD will search to discover the
# available audio files and add them to the daemon's online database. This 
# setting defaults to the XDG directory, otherwise the music directory will be
# be disabled and audio files will only be accepted over ipc socket (using
# file:// protocol) or streaming files over an accepted protocol.
#
music_directory		"~/u/music"
#
# This setting sets the MPD internal playlist directory. The purpose of this
# directory is storage for playlists created by MPD. The server will use 
# playlist files not created by the server but only if they are in the MPD
# format. This setting defaults to playlist saving being disabled.
#
playlist_directory		"~/.mpd/playlists"
#
# This setting sets the location of the MPD database. This file is used to
# load the database at server start up and store the database while the 
# server is not up. This setting defaults to disabled which will allow
# MPD to accept files over ipc socket (using file:// protocol) or streaming
# files over an accepted protocol.
#
db_file			"~/.mpd/database"
# 
# These settings are the locations for the daemon log files for the daemon.
# These logs are great for troubleshooting, depending on your log_level
# settings.
#
# The special value "syslog" makes MPD use the local syslog daemon. This
# setting defaults to logging to syslog, otherwise logging is disabled.
#
log_file			"~/.mpd/log"
#
# This setting sets the location of the file which stores the process ID
# for use of mpd --kill and some init scripts. This setting is disabled by
# default and the pid file will not be stored.
#
pid_file			"~/.mpd/pid"
#
# This setting sets the location of the file which contains information about
# most variables to get MPD back into the same general shape it was in before
# it was brought down. This setting is disabled by default and the server 
# state will be reset on server start up.
#
state_file			"~/.mpd/state"
#
# The location of the sticker database.  This is a database which
# manages dynamic information attached to songs.
#
sticker_file			"~/.mpd/sticker.sql"
#
###############################################################################


# General music daemon options ################################################
#
# This setting specifies the user that MPD will run as. MPD should never run as
# root and you may use this setting to make MPD change its user ID after
# initialization. This setting is disabled by default and MPD is run as the
# current user.
#
#user				"nobody"
#
# This setting specifies the group that MPD will run as. If not specified
# primary group of user specified with "user" setting will be used (if set).
# This is useful if MPD needs to be a member of group such as "audio" to
# have permission to use sound card.
#
#group				"nogroup"
#
# This setting sets the address for the daemon to listen on. Careful attention
# should be paid if this is assigned to anything other then the default, any.
# This setting can deny access to control of the daemon. Not effective if
# systemd socket activiation is in use.
#
# For network
#bind_to_address		"any"
#
# And for Unix Socket
#bind_to_address		"~/.mpd/socket"
#
# This setting is the TCP port that is desired for the daemon to get assigned
# to.
#
#port				"6600"
#
# This setting controls the type of information which is logged. Available 
# setting arguments are "default", "secure" or "verbose". The "verbose" setting
# argument is recommended for troubleshooting, though can quickly stretch
# available resources on limited hardware storage.
#
#log_level			"default"
#
# If you have a problem with your MP3s ending abruptly it is recommended that 
# you set this argument to "no" to attempt to fix the problem. If this solves
# the problem, it is highly recommended to fix the MP3 files with vbrfix
# (available from <http://www.willwap.co.uk/Programs/vbrfix.php>), at which
# point gapless MP3 playback can be enabled.
#
#gapless_mp3_playback			"yes"
#
# Setting "restore_paused" to "yes" puts MPD into pause mode instead
# of starting playback after startup.
#
#restore_paused "no"
#
# This setting enables MPD to create playlists in a format usable by other
# music players.
#
#save_absolute_paths_in_playlists	"no"
#
# This setting defines a list of tag types that will be extracted during the
# audio file discovery process. The complete list of possible values can be
# found in the user manual.
#metadata_to_use	"artist,album,title,track,name,genre,date,composer,performer,disc"
#
# This setting enables automatic update of MPD's database when files in 
# music_directory are changed.
#
#auto_update	"yes"
#
# Limit the depth of the directories being watched, 0 means only watch
# the music directory itself.  There is no limit by default.
#
#auto_update_depth "3"
#
###############################################################################


# Symbolic link behavior ######################################################
#
# If this setting is set to "yes", MPD will discover audio files by following 
# symbolic links outside of the configured music_directory.
#
#follow_outside_symlinks	"yes"
#
# If this setting is set to "yes", MPD will discover audio files by following
# symbolic links inside of the configured music_directory.
#
#follow_inside_symlinks		"yes"
#
###############################################################################


# Zeroconf / Avahi Service Discovery ##########################################
#
# If this setting is set to "yes", service information will be published with
# Zeroconf / Avahi.
#
#zeroconf_enabled		"yes"
#
# The argument to this setting will be the Zeroconf / Avahi unique name for
# this MPD server on the network.
#
#zeroconf_name			"Music Player"
#
###############################################################################


# Permissions #################################################################
#
# If this setting is set, MPD will require password authorization. The password
# setting can be specified multiple times for different password profiles.
#
#password                        "password@read,add,control,admin"
#
# This setting specifies the permissions a user has who has not yet logged in. 
#
#default_permissions             "read,add,control,admin"
#
###############################################################################


# Database #######################################################################
#

#database {
#       plugin "proxy"
#       host "other.mpd.host"
#       port "6600"
#}

# Input #######################################################################
#

input {
        plugin "curl"
#       proxy "proxy.isp.com:8080"
#       proxy_user "user"
#       proxy_password "password"
}

#
###############################################################################

# Audio Output ################################################################
#

audio_output {
    type    "pulse"
    name    "pulse audio"
}

audio_output {
    type    "fifo"
    name    "my_fifo"
    path    "/tmp/mpd.fifo"
    format  "44100:16:2"
}

# MPD supports various audio output types, as well as playing through multiple 
# audio outputs at the same time, through multiple audio_output settings 
# blocks. Setting this block is optional, though the server will only attempt
# autodetection for one sound card.
#
# An example of an ALSA output:
#
#audio_output {
#	type		"alsa"
#	name		"My ALSA Device"
##	device		"hw:0,0"	# optional
##	mixer_type      "hardware"	# optional
##	mixer_device	"default"	# optional
##	mixer_control	"PCM"		# optional
##	mixer_index	"0"		# optional
#}
#
# An example of an OSS output:
#
#audio_output {
#	type		"oss"
#	name		"My OSS Device"
##	device		"/dev/dsp"	# optional
##	mixer_type      "hardware"	# optional
##	mixer_device	"/dev/mixer"	# optional
##	mixer_control	"PCM"		# optional
#}
#
# An example of a shout output (for streaming to Icecast):
#
#audio_output {
#	type		"shout"
#	encoder		"vorbis"		# optional
#	name		"My Shout Stream"
#	host		"localhost"
#	port		"8000"
#	mount		"/mpd.ogg"
#	password	"hackme"
#	quality		"5.0"
#	bitrate		"128"
#	format		"44100:16:1"
##	protocol	"icecast2"		# optional
##	user		"source"		# optional
##	description	"My Stream Description"	# optional
##	url		"http://example.com"	# optional
##	genre		"jazz"			# optional
##	public		"no"			# optional
##	timeout		"2"			# optional
##	mixer_type      "software"		# optional
#}
#
# An example of a recorder output:
#
#audio_output {
#	type		"recorder"
#	name		"My recorder"
#	encoder		"vorbis"		# optional, vorbis or lame
#	path		"/var/lib/mpd/recorder/mpd.ogg"
##	quality		"5.0"			# do not define if bitrate is defined
#	bitrate		"128"			# do not define if quality is defined
#	format		"44100:16:1"
#}
#
# An example of a httpd output (built-in HTTP streaming server):
#
#audio_output {
#	type		"httpd"
#	name		"My HTTP Stream"
#	encoder		"vorbis"		# optional, vorbis or lame
#	port		"8000"
#	bind_to_address	"0.0.0.0"		# optional, IPv4 or IPv6
##	quality		"5.0"			# do not define if bitrate is defined
#	bitrate		"128"			# do not define if quality is defined
#	format		"44100:16:1"
#	max_clients	"0"			# optional 0=no limit
#}
#
# An example of a pulseaudio output (streaming to a remote pulseaudio server)
#
#audio_output {
#	type		"pulse"
#	name		"My Pulse Output"
##	server		"remote_server"		# optional
##	sink		"remote_server_sink"	# optional
#}
#
# An example of a winmm output (Windows multimedia API).
#
#audio_output {
#	type		"winmm"
#	name		"My WinMM output"
##	device		"Digital Audio (S/PDIF) (High Definition Audio Device)" # optional
#		or
##	device		"0"		# optional
##	mixer_type	"hardware"	# optional
#}
#
# An example of an openal output.
#
#audio_output {
#	type		"openal"
#	name		"My OpenAL output"
##	device		"Digital Audio (S/PDIF) (High Definition Audio Device)" # optional
#}
#
# An example of an sndio output.
#
#audio_output {
#	type		"sndio"
#	name		"sndio output"
#	mixer_type	"software"
#}
#
# An example of an OS X output:
#
#audio_output {
#	type		"osx"
#	name		"My OS X Device"
##	device		"Built-in Output"	# optional
##	channel_map      "-1,-1,0,1"	# optional
#}
#
## Example "pipe" output:
#
#audio_output {
#	type		"pipe"
#	name		"my pipe"
#	command		"aplay -f cd 2>/dev/null"
## Or if you're want to use AudioCompress
#	command		"AudioCompress -m | aplay -f cd 2>/dev/null"
## Or to send raw PCM stream through PCM:
#	command		"nc example.org 8765"
#	format		"44100:16:2"
#}
#
## An example of a null output (for no audio output):
#
#audio_output {
#	type		"null"
#	name		"My Null Output"
#	mixer_type      "none"			# optional
#}
#
###############################################################################


# Normalization automatic volume adjustments ##################################
#
# This setting specifies the type of ReplayGain to use. This setting can have
# the argument "off", "album", "track" or "auto". "auto" is a special mode that
# chooses between "track" and "album" depending on the current state of
# random playback. If random playback is enabled then "track" mode is used.
# See <http://www.replaygain.org> for more details about ReplayGain.
# This setting is off by default.
#
#replaygain			"album"
#
# This setting sets the pre-amp used for files that have ReplayGain tags. By
# default this setting is disabled.
#
#replaygain_preamp		"0"
#
# This setting sets the pre-amp used for files that do NOT have ReplayGain tags.
# By default this setting is disabled.
#
#replaygain_missing_preamp	"0"
#
# This setting enables or disables ReplayGain limiting.
# MPD calculates actual amplification based on the ReplayGain tags
# and replaygain_preamp / replaygain_missing_preamp setting.
# If replaygain_limit is enabled MPD will never amplify audio signal
# above its original level. If replaygain_limit is disabled such amplification
# might occur. By default this setting is enabled.
#
#replaygain_limit		"yes"
#
# This setting enables on-the-fly normalization volume adjustment. This will
# result in the volume of all playing audio to be adjusted so the output has 
# equal "loudness". This setting is disabled by default.
#
#volume_normalization		"no"
#
###############################################################################

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