mpd.conf 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362
  1. ## MPD configuration file.
  2. ## Read the user manual for documentation: http://www.musicpd.org/doc/user/
  3. ## or /usr/share/doc/mpd/user-manual.html
  4. ## Files and directories
  5. ## This setting controls the top directory which MPD will search to discover the
  6. ## available audio files and add them to the daemon's online database. This
  7. ## setting defaults to the XDG directory, otherwise the music directory will be
  8. ## be disabled and audio files will only be accepted over ipc socket (using
  9. ## file:// protocol) or streaming files over an accepted protocol.
  10. music_directory "/mnt/Music"
  11. ## This setting sets the MPD internal playlist directory. The purpose of this
  12. # directory is storage for playlists created by MPD. The server will use
  13. ## playlist files not created by the server but only if they are in the MPD
  14. ## format. This setting defaults to playlist saving being disabled.
  15. playlist_directory "/home/matthew/.mpd/playlists"
  16. ## This setting sets the location of the MPD database. This file is used to
  17. ## load the database at server start up and store the database while the
  18. ## server is not up. This setting defaults to disabled which will allow
  19. ## MPD to accept files over ipc socket (using file:// protocol) or streaming
  20. ## files over an accepted protocol.
  21. db_file "/home/matthew/.mpd/mpd.db"
  22. ##
  23. ## These settings are the locations for the daemon log files for the daemon.
  24. ## These logs are great for troubleshooting, depending on your log_level
  25. ## settings. The special value "syslog" makes MPD use the local syslog daemon. This
  26. ## setting defaults to logging to syslog, otherwise logging is disabled.
  27. log_file "/home/matthew/.mpd/mpd.log"
  28. ## This setting sets the location of the file which stores the process ID
  29. ## for use of mpd --kill and some init scripts. This setting is disabled by
  30. ## default and the pid file will not be stored.
  31. pid_file "/home/matthew/.mpd/mpd.pid"
  32. ## This setting sets the location of the file which contains information about
  33. ## most variables to get MPD back into the same general shape it was in before
  34. ## it was brought down. This setting is disabled by default and the server
  35. ## state will be reset on server start up.
  36. state_file "/home/matthew/.mpd/mpdstate"
  37. ## The location of the sticker database. This is a database which
  38. ## manages dynamic information attached to songs.
  39. ##sticker_file "/var/lib/mpd/sticker.sql"
  40. ## General music daemon options
  41. ## This setting specifies the user that MPD will run as. MPD should never run as
  42. ## root and you may use this setting to make MPD change its user ID after
  43. ## initialization. This setting is disabled by default and MPD is run as the
  44. ## current user.
  45. user "matthew"
  46. ## This setting specifies the group that MPD will run as. If not specified
  47. ## primary group of user specified with "user" setting will be used (if set).
  48. ## This is useful if MPD needs to be a member of group such as "audio" to
  49. ## have permission to use sound card.
  50. ## group "users"
  51. ## This setting sets the address for the daemon to listen on. Careful attention
  52. ## should be paid if this is assigned to anything other then the default, any.
  53. ## This setting can deny access to control of the daemon. Choose any if you want
  54. ## to have mpd listen on every address
  55. ## For network
  56. bind_to_address "localhost"
  57. ## And for Unix Socket
  58. ## bind_to_address "/run/mpd/socket"
  59. ## This setting is the TCP port that is desired for the daemon to get assigned to.
  60. port "6601"
  61. ## This setting controls the type of information which is logged. Available
  62. ## setting arguments are "default", "secure" or "verbose". The "verbose" setting
  63. ## argument is recommended for troubleshooting, though can quickly stretch
  64. ## available resources on limited hardware storage.
  65. log_level "default"
  66. ## If you have a problem with your MP3s ending abruptly it is recommended that
  67. ## you set this argument to "no" to attempt to fix the problem. If this solves
  68. ## the problem, it is highly recommended to fix the MP3 files with vbrfix
  69. ## (available as vbrfix in the debian archive), at which
  70. ## point gapless MP3 playback can be enabled.
  71. ## gapless_mp3_playback "yes"
  72. ## Setting "restore_paused" to "yes" puts MPD into pause mode instead
  73. ## of starting playback after startup.
  74. restore_paused "yes"
  75. ## This setting enables MPD to create playlists in a format usable by other
  76. ## music players.
  77. save_absolute_paths_in_playlists "yes"
  78. ## This setting defines a list of tag types that will be extracted during the
  79. ## audio file discovery process. The complete list of possible values can be
  80. ## found in the mpd.conf man page.
  81. metadata_to_use "artist,album,title,track,name,genre,date,composer,performer,disc"
  82. ## This setting enables automatic update of MPD's database when files in
  83. ## music_directory are changed.
  84. auto_update "yes"
  85. ## Limit the depth of the directories being watched, 0 means only watch
  86. ## the music directory itself. There is no limit by default.
  87. ## auto_update_depth "3"
  88. ## Symbolic link behavior
  89. ## If this setting is set to "yes", MPD will discover audio files by following
  90. ## symbolic links outside of the configured music_directory.
  91. follow_outside_symlinks "yes"
  92. ## If this setting is set to "yes", MPD will discover audio files by following
  93. ## symbolic links inside of the configured music_directory.
  94. follow_inside_symlinks "yes"
  95. ## Zeroconf/Avahi Service Discovery
  96. ## If this setting is set to "yes", service information will be published with
  97. ## Zeroconf / Avahi.
  98. ## zeroconf_enabled "yes"
  99. ## The argument to this setting will be the Zeroconf / Avahi unique name for
  100. ## this MPD server on the network.
  101. ## zeroconf_name "Music Player"
  102. ## Permissions
  103. ## If this setting is set, MPD will require password authorization. The password
  104. ## can setting can be specified multiple times for different password profiles.
  105. ## password "password@read,add,control,admin"
  106. ## This setting specifies the permissions a user has who has not yet logged in.
  107. ## default_permissions "read,add,control,admin"
  108. ## Database
  109. ## database {
  110. ## plugin "proxy"
  111. ## host "other.mpd.host"
  112. ## port "6600"
  113. ##}
  114. ## Input
  115. input {
  116. plugin "curl"
  117. ## proxy "proxy.isp.com:8080"
  118. ## proxy_user "user"
  119. ## proxy_password "password"
  120. }
  121. ## Audio Output
  122. ## MPD supports various audio output types, as well as playing through multiple
  123. ## audio outputs at the same time, through multiple audio_output settings
  124. ## blocks. Setting this block is optional, though the server will only attempt
  125. ## autodetection for one sound card.
  126. ## An example of an ALSA output:
  127. audio_output {
  128. type "alsa"
  129. name "My ALSA Device"
  130. # device "hw:0,0" # optional
  131. # mixer_type "hardware" # optional
  132. # mixer_device "default" # optional
  133. # mixer_control "PCM" # optional
  134. # mixer_index "0" # optional
  135. }
  136. ## FIFO OUTPUT FOR VISUALIZATION
  137. audio_output {
  138. type "fifo"
  139. name "my_fifo"
  140. path "/tmp/mpd.fifo"
  141. format "44100:16:2"
  142. }
  143. ##
  144. ## An example of an OSS output:
  145. ## audio_output {
  146. ## type "oss"
  147. ## name "My OSS Device"
  148. ## device "/dev/dsp" # optional
  149. ## mixer_type "hardware" # optional
  150. ## mixer_device "/dev/mixer" # optional
  151. ## mixer_control "PCM" # optional
  152. ##}
  153. ## An example of a shout output (for streaming to Icecast):
  154. ##audio_output {
  155. ## type "shout"
  156. ## encoding "ogg" # optional
  157. ## name "My Shout Stream"
  158. ## host "localhost"
  159. ## port "8000"
  160. ## mount "/mpd.ogg"
  161. ## password "hackme"
  162. ## quality "5.0"
  163. ## bitrate "128"
  164. ## format "44100:16:1"
  165. ## protocol "icecast2" # optional
  166. ## user "source" # optional
  167. ## description "My Stream Description" # optional
  168. ## url "http://example.com" # optional
  169. ## genre "jazz" # optional
  170. ## public "no" # optional
  171. ## timeout "2" # optional
  172. ## mixer_type "software" # optional
  173. ##}
  174. ## An example of a recorder output:
  175. ## audio_output {
  176. ## type "recorder"
  177. ## name "My recorder"
  178. ## encoder "vorbis" # optional, vorbis or lame
  179. ## path "/var/lib/mpd/recorder/mpd.ogg"
  180. ### quality "5.0" # do not define if bitrate is defined
  181. ## bitrate "128" # do not define if quality is defined
  182. ## format "44100:16:1"
  183. ##}
  184. ## An example of a httpd output (built-in HTTP streaming server):
  185. ## audio_output {
  186. ## type "httpd"
  187. ## name "My HTTP Stream"
  188. ## encoder "vorbis" # optional, vorbis or lame
  189. ## port "8000"
  190. ## bind_to_address "0.0.0.0" # optional, IPv4 or IPv6
  191. ## quality "5.0" # do not define if bitrate is defined
  192. ## bitrate "128" # do not define if quality is defined
  193. ## format "44100:16:1"
  194. ## max_clients "0" # optional 0=no limit
  195. ##}
  196. ## An example of a pulseaudio output (streaming to a remote pulseaudio server)
  197. ## Please see README.Debian if you want mpd to play through the pulseaudio
  198. ## daemon started as part of your graphical desktop session!
  199. ## audio_output {
  200. ## type "pulse"
  201. ## name "My Pulse Output"
  202. ## server "remote_server" # optional
  203. ## sink "remote_server_sink" # optional
  204. ##}
  205. ## An example of a winmm output (Windows multimedia API).
  206. ## audio_output {
  207. ## type "winmm"
  208. ## name "My WinMM output"
  209. ## device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional
  210. ## or
  211. ## device "0" # optional
  212. ## mixer_type "hardware" # optional
  213. ##}
  214. ## An example of an openal output.
  215. ## audio_output {
  216. ## type "openal"
  217. ## name "My OpenAL output"
  218. ## device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional
  219. ##}
  220. ## Example "pipe" output:
  221. ## audio_output {
  222. ## type "pipe"
  223. ## name "my pipe"
  224. ## command "aplay -f cd 2>/dev/null"
  225. ## Or if you're want to use AudioCompress
  226. ## command "AudioCompress -m | aplay -f cd 2>/dev/null"
  227. ## Or to send raw PCM stream through PCM:
  228. ## command "nc example.org 8765"
  229. ## format "44100:16:2"
  230. ##}
  231. ## An example of a null output (for no audio output):
  232. ## audio_output {
  233. ## type "null"
  234. ## name "My Null Output"
  235. ## mixer_type "none" # optional
  236. ##}
  237. ## If MPD has been compiled with libsamplerate support, this setting specifies
  238. ## the sample rate converter to use. Possible values can be found in the
  239. ## mpd.conf man page or the libsamplerate documentation. By default, this is
  240. ## setting is disabled.
  241. ## samplerate_converter "Fastest Sinc Interpolator"
  242. ## Normalization automatic volume adjustments
  243. ## This setting specifies the type of ReplayGain to use. This setting can have
  244. ## the argument "off", "album", "track" or "auto". "auto" is a special mode that
  245. ## chooses between "track" and "album" depending on the current state of
  246. ## random playback. If random playback is enabled then "track" mode is used.
  247. ## See <http://www.replaygain.org> for more details about ReplayGain.
  248. ## This setting is off by default.
  249. ## replaygain "album"
  250. ## This setting sets the pre-amp used for files that have ReplayGain tags. By
  251. ## default this setting is disabled.
  252. ## replaygain_preamp "0"
  253. ## This setting sets the pre-amp used for files that do NOT have ReplayGain tags.
  254. ## By default this setting is disabled.
  255. ## replaygain_missing_preamp "0"
  256. ## This setting enables or disables ReplayGain limiting.
  257. ## MPD calculates actual amplification based on the ReplayGain tags
  258. ## and replaygain_preamp / replaygain_missing_preamp setting.
  259. ## If replaygain_limit is enabled MPD will never amplify audio signal
  260. ## above its original level. If replaygain_limit is disabled such amplification
  261. ## might occur. By default this setting is enabled.
  262. ## replaygain_limit "yes"
  263. ## This setting enables on-the-fly normalization volume adjustment. This will
  264. ## result in the volume of all playing audio to be adjusted so the output has
  265. ## equal "loudness". This setting is disabled by default.
  266. ## volume_normalization "no"
  267. ## MPD Internal Buffering
  268. ## This setting adjusts the size of internal decoded audio buffering. Changing
  269. ## this may have undesired effects. Don't change this if you don't know what you
  270. ## are doing.
  271. ## audio_buffer_size "4096"
  272. ## This setting controls the percentage of the buffer which is filled before
  273. ## beginning to play. Increasing this reduces the chance of audio file skipping,
  274. ## at the cost of increased time prior to audio playback.
  275. ## buffer_before_play "10%"
  276. ## Resource Limitations
  277. ## These settings are various limitations to prevent MPD from using too many
  278. ## resources. Generally, these settings should be minimized to prevent security
  279. ## risks, depending on the operating resources.
  280. ## connection_timeout "60"
  281. ## max_connections "10"
  282. ## max_playlist_length "16384"
  283. ## max_command_list_size "2048"
  284. ## max_output_buffer_size "8192"
  285. ## Character Encoding
  286. ## If file or directory names do not display correctly for your locale then you
  287. ## may need to modify this setting.
  288. filesystem_charset "UTF-8"
  289. ## This setting controls the encoding that ID3v1 tags should be converted from.
  290. id3v1_encoding "UTF-8"
  291. ## SIDPlay decoder
  292. ## songlength_database:
  293. ## Location of your songlengths file, as distributed with the HVSC.
  294. ## The sidplay plugin checks this for matching MD5 fingerprints.
  295. ## See http://www.c64.org/HVSC/DOCUMENTS/Songlengths.faq
  296. ## default_songlength:
  297. ## This is the default playing time in seconds for songs not in the
  298. ## songlength database, or in case you're not using a database.
  299. ## A value of 0 means play indefinitely.
  300. ## filter:
  301. ## Turns the SID filter emulation on or off.
  302. ## decoder {
  303. ## plugin "sidplay"
  304. ## songlength_database "/media/C64Music/DOCUMENTS/Songlengths.txt"
  305. ## default_songlength "120"
  306. ## filter "true"
  307. ##}