add mpd and ncmpcpp configs
[~bandali/configs] / mpd / .config / mpd / mpd.conf
CommitLineData
1d1e7a26
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#
13music_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#
20playlist_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#
28db_file "~/.config/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#
37log_file "~/.config/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#
43pid_file "~/.config/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#
50state_file "~/.config/mpd/state"
51#
52# The location of the sticker database. This is a database which
53# manages dynamic information attached to songs.
54#
55sticker_file "~/.config/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.
79#
80# For network
81#bind_to_address "any"
82#
83# And for Unix Socket
84#bind_to_address "~/.mpd/socket"
85#
86# This setting is the TCP port that is desired for the daemon to get assigned
87# to.
88#
89#port "6600"
90#
91# This setting controls the type of information which is logged. Available
92# setting arguments are "default", "secure" or "verbose". The "verbose" setting
93# argument is recommended for troubleshooting, though can quickly stretch
94# available resources on limited hardware storage.
95#
96#log_level "default"
97#
98# If you have a problem with your MP3s ending abruptly it is recommended that
99# you set this argument to "no" to attempt to fix the problem. If this solves
100# the problem, it is highly recommended to fix the MP3 files with vbrfix
101# (available from <http://www.willwap.co.uk/Programs/vbrfix.php>), at which
102# point gapless MP3 playback can be enabled.
103#
104#gapless_mp3_playback "yes"
105#
106# Setting "restore_paused" to "yes" puts MPD into pause mode instead
107# of starting playback after startup.
108#
109#restore_paused "no"
110#
111# This setting enables MPD to create playlists in a format usable by other
112# music players.
113#
114#save_absolute_paths_in_playlists "no"
115#
116# This setting defines a list of tag types that will be extracted during the
117# audio file discovery process. The complete list of possible values can be
118# found in the mpd.conf man page.
119#metadata_to_use "artist,album,title,track,name,genre,date,composer,performer,disc"
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.
158#
159#zeroconf_name "Music Player"
160#
161###############################################################################
162
163
164# Permissions #################################################################
165#
166# If this setting is set, MPD will require password authorization. The password
167# can 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
181#database {
182# plugin "proxy"
183# host "other.mpd.host"
184# port "6600"
185#}
186
187# Input #######################################################################
188#
189
190input {
191 plugin "curl"
192# proxy "proxy.isp.com:8080"
193# proxy_user "user"
194# proxy_password "password"
195}
196
197#
198###############################################################################
199
200# Audio Output ################################################################
201#
202# MPD supports various audio output types, as well as playing through multiple
203# audio outputs at the same time, through multiple audio_output settings
204# blocks. Setting this block is optional, though the server will only attempt
205# autodetection for one sound card.
206#
207# An example of an ALSA output:
208#
209#audio_output {
210 #type "alsa"
211 #name "My ALSA Device"
212## device "hw:0,0" # optional
213### mixer_type "hardware" # optional
214### mixer_device "default" # optional
215### mixer_control "PCM" # optional
216### mixer_index "0" # optional
217#}
218
219audio_output {
220 type "alsa"
221 name "My ALSA Device"
222}
223
224audio_output {
225 type "fifo"
226 name "my_fifo"
227 path "/tmp/mpd.fifo"
228 format "44100:16:2"
229 }
230
231#
232# An example of an OSS output:
233#
234#audio_output {
235# type "oss"
236# name "My OSS Device"
237## device "/dev/dsp" # optional
238## mixer_type "hardware" # optional
239## mixer_device "/dev/mixer" # optional
240## mixer_control "PCM" # optional
241#}
242#
243# An example of a shout output (for streaming to Icecast):
244#
245#audio_output {
246# type "shout"
247# encoding "ogg" # optional
248# name "My Shout Stream"
249# host "localhost"
250# port "8000"
251# mount "/mpd.ogg"
252# password "hackme"
253# quality "5.0"
254# bitrate "128"
255# format "44100:16:1"
256## protocol "icecast2" # optional
257## user "source" # optional
258## description "My Stream Description" # optional
259## url "http://example.com" # optional
260## genre "jazz" # optional
261## public "no" # optional
262## timeout "2" # optional
263## mixer_type "software" # optional
264#}
265#
266# An example of a recorder output:
267#
268#audio_output {
269# type "recorder"
270# name "My recorder"
271# encoder "vorbis" # optional, vorbis or lame
272# path "/var/lib/mpd/recorder/mpd.ogg"
273## quality "5.0" # do not define if bitrate is defined
274# bitrate "128" # do not define if quality is defined
275# format "44100:16:1"
276#}
277#
278# An example of a httpd output (built-in HTTP streaming server):
279#
280#audio_output {
281# type "httpd"
282# name "My HTTP Stream"
283# encoder "vorbis" # optional, vorbis or lame
284# port "8000"
285# bind_to_address "0.0.0.0" # optional, IPv4 or IPv6
286## quality "5.0" # do not define if bitrate is defined
287# bitrate "128" # do not define if quality is defined
288# format "44100:16:1"
289# max_clients "0" # optional 0=no limit
290#}
291#
292# An example of a pulseaudio output (streaming to a remote pulseaudio server)
293#
294#audio_output {
295# type "pulse"
296# name "My Pulse Output"
297## server "remote_server" # optional
298## sink "remote_server_sink" # optional
299#}
300#
301# An example of a winmm output (Windows multimedia API).
302#
303#audio_output {
304# type "winmm"
305# name "My WinMM output"
306## device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional
307# or
308## device "0" # optional
309## mixer_type "hardware" # optional
310#}
311#
312# An example of an openal output.
313#
314#audio_output {
315# type "openal"
316# name "My OpenAL output"
317## device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional
318#}
319#
320## Example "pipe" output:
321#
322#audio_output {
323# type "pipe"
324# name "my pipe"
325# command "aplay -f cd 2>/dev/null"
326## Or if you're want to use AudioCompress
327# command "AudioCompress -m | aplay -f cd 2>/dev/null"
328## Or to send raw PCM stream through PCM:
329# command "nc example.org 8765"
330# format "44100:16:2"
331#}
332#
333## An example of a null output (for no audio output):
334#
335#audio_output {
336# type "null"
337# name "My Null Output"
338# mixer_type "none" # optional
339#}
340#
341# If MPD has been compiled with libsamplerate support, this setting specifies
342# the sample rate converter to use. Possible values can be found in the
343# mpd.conf man page or the libsamplerate documentation. By default, this is
344# setting is disabled.
345#
346#samplerate_converter "Fastest Sinc Interpolator"
347#
348###############################################################################
349
350
351# Normalization automatic volume adjustments ##################################
352#
353# This setting specifies the type of ReplayGain to use. This setting can have
354# the argument "off", "album", "track" or "auto". "auto" is a special mode that
355# chooses between "track" and "album" depending on the current state of
356# random playback. If random playback is enabled then "track" mode is used.
357# See <http://www.replaygain.org> for more details about ReplayGain.
358# This setting is off by default.
359#
360#replaygain "album"
361#
362# This setting sets the pre-amp used for files that have ReplayGain tags. By
363# default this setting is disabled.
364#
365#replaygain_preamp "0"
366#
367# This setting sets the pre-amp used for files that do NOT have ReplayGain tags.
368# By default this setting is disabled.
369#
370#replaygain_missing_preamp "0"
371#
372# This setting enables or disables ReplayGain limiting.
373# MPD calculates actual amplification based on the ReplayGain tags
374# and replaygain_preamp / replaygain_missing_preamp setting.
375# If replaygain_limit is enabled MPD will never amplify audio signal
376# above its original level. If replaygain_limit is disabled such amplification
377# might occur. By default this setting is enabled.
378#
379#replaygain_limit "yes"
380#
381# This setting enables on-the-fly normalization volume adjustment. This will
382# result in the volume of all playing audio to be adjusted so the output has
383# equal "loudness". This setting is disabled by default.
384#
385#volume_normalization "no"
386#
387###############################################################################
388
389
390# MPD Internal Buffering ######################################################
391#
392# This setting adjusts the size of internal decoded audio buffering. Changing
393# this may have undesired effects. Don't change this if you don't know what you
394# are doing.
395#
396#audio_buffer_size "4096"
397#
398# This setting controls the percentage of the buffer which is filled before
399# beginning to play. Increasing this reduces the chance of audio file skipping,
400# at the cost of increased time prior to audio playback.
401#
402#buffer_before_play "10%"
403#
404###############################################################################
405
406
407# Resource Limitations ########################################################
408#
409# These settings are various limitations to prevent MPD from using too many
410# resources. Generally, these settings should be minimized to prevent security
411# risks, depending on the operating resources.
412#
413#connection_timeout "60"
414#max_connections "10"
415#max_playlist_length "16384"
416#max_command_list_size "2048"
417#max_output_buffer_size "8192"
418#
419###############################################################################
420
421# Character Encoding ##########################################################
422#
423# If file or directory names do not display correctly for your locale then you
424# may need to modify this setting.
425#
426#filesystem_charset "UTF-8"
427#
428# This setting controls the encoding that ID3v1 tags should be converted from.
429#
430#id3v1_encoding "ISO-8859-1"
431#
432###############################################################################
433
434
435# SIDPlay decoder #############################################################
436#
437# songlength_database:
438# Location of your songlengths file, as distributed with the HVSC.
439# The sidplay plugin checks this for matching MD5 fingerprints.
440# See http://www.c64.org/HVSC/DOCUMENTS/Songlengths.faq
441#
442# default_songlength:
443# This is the default playing time in seconds for songs not in the
444# songlength database, or in case you're not using a database.
445# A value of 0 means play indefinitely.
446#
447# filter:
448# Turns the SID filter emulation on or off.
449#
450#decoder {
451# plugin "sidplay"
452# songlength_database "/media/C64Music/DOCUMENTS/Songlengths.txt"
453# default_songlength "120"
454# filter "true"
455#}
456#
457###############################################################################
458