* .config/isync/mbsyncrc: Switch to new Far/Near terminology.
[~bandali/configs] / .config / mpd / mpd.conf
... / ...
CommitLineData
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 "~/u/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 "~/.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 "~/.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 "~/.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 "~/.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 "~/.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 "~/.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
191input {
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
204audio_output {
205 type "pulse"
206 name "pulse audio"
207}
208
209audio_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###############################################################################