]> git.pld-linux.org Git - packages/mpd.git/blame - mpd.conf
updated deprecated meson macros
[packages/mpd.git] / mpd.conf
CommitLineData
aac54f87
ZU
1# Base configuration file for MPD on PLD-linux
2#
3# Based on the example configuration file for MPD
4# See the mpd.conf man page for a more detailed description of each parameter.
aac54f87 5#
4351e719
JP
6# Files and directories #######################################################
7#
8# This setting controls the top directory which MPD will search to discover the
9# available audio files and add them to the daemon's online database. This
10# setting defaults to the XDG directory, otherwise the music directory will be
11# be disabled and audio files will only be accepted over ipc socket (using
12# file:// protocol) or streaming files over an accepted protocol.
aac54f87 13#
4351e719
JP
14music_directory "/music"
15#
16# This setting sets the MPD internal playlist directory. The purpose of this
17# directory is storage for playlists created by MPD. The server will use
18# playlist files not created by the server but only if they are in the MPD
19# format. This setting defaults to playlist saving being disabled.
20#
21playlist_directory "/var/lib/mpd/playlists"
22#
23# This setting sets the location of the MPD database. This file is used to
24# load the database at server start up and store the database while the
25# server is not up. This setting defaults to disabled which will allow
26# MPD to accept files over ipc socket (using file:// protocol) or streaming
27# files over an accepted protocol.
28#
29db_file "/var/lib/mpd/mpd.db"
30#
31# These settings are the locations for the daemon log files for the daemon.
32# These logs are great for troubleshooting, depending on your log_level
33# settings.
aac54f87 34#
4351e719
JP
35# The special value "syslog" makes MPD use the local syslog daemon. This
36# setting defaults to logging to syslog, otherwise logging is disabled.
aac54f87 37#
4351e719 38log_file "/var/log/mpd/mpd.log"
aac54f87 39#
4351e719
JP
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#
44pid_file "/var/run/mpd/mpd.pid"
45#
46# This setting sets the location of the file which contains information about
47# most variables to get MPD back into the same general shape it was in before
48# it was brought down. This setting is disabled by default and the server
49# state will be reset on server start up.
50#
51state_file "/var/lib/mpd/mpdstate"
52#
53# The location of the sticker database. This is a database which
54# manages dynamic information attached to songs.
55#
56sticker_file "/var/lib/mpd/sticker.sql"
57#
58###############################################################################
aac54f87
ZU
59
60
4351e719
JP
61# General music daemon options ################################################
62#
63# This setting specifies the user that MPD will run as. MPD should never run as
64# root and you may use this setting to make MPD change its user ID after
65# initialization. This setting is disabled by default and MPD is run as the
66# current user.
67#
68user "mpd"
69#
70# This setting specifies the group that MPD will run as. If not specified
71# primary group of user specified with "user" setting will be used (if set).
72# This is useful if MPD needs to be a member of group such as "audio" to
73# have permission to use sound card.
aac54f87 74#
4351e719 75#group "nogroup"
aac54f87 76#
4351e719
JP
77# This setting sets the address for the daemon to listen on. Careful attention
78# should be paid if this is assigned to anything other then the default, any.
79# This setting can deny access to control of the daemon.
aac54f87 80#
4351e719
JP
81# For network
82#bind_to_address "any"
aac54f87 83#
4351e719
JP
84# And for Unix Socket
85#bind_to_address "~/.mpd/socket"
aac54f87 86#
4351e719
JP
87# This setting is the TCP port that is desired for the daemon to get assigned
88# to.
aac54f87 89#
4351e719 90#port "6600"
aac54f87 91#
4351e719
JP
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# 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. Optionally, 'comment' can be added to this
114# list.
115#
116#metadata_to_use "artist,album,title,track,name,genre,date,composer,performer,disc"
117#
118# This setting enables automatic update of MPD's database when files in
119# music_directory are changed.
120#
121#auto_update "yes"
122#
123# Limit the depth of the directories being watched, 0 means only watch
124# the music directory itself. There is no limit by default.
125#
126#auto_update_depth "3"
127#
128###############################################################################
aac54f87
ZU
129
130
4351e719 131# Symbolic link behavior ######################################################
aac54f87 132#
4351e719
JP
133# If this setting is set to "yes", MPD will discover audio files by following
134# symbolic links outside of the configured music_directory.
aac54f87 135#
4351e719 136#follow_outside_symlinks "yes"
aac54f87 137#
4351e719
JP
138# If this setting is set to "yes", MPD will discover audio files by following
139# symbolic links inside of the configured music_directory.
aac54f87 140#
4351e719 141#follow_inside_symlinks "yes"
aac54f87 142#
4351e719 143###############################################################################
aac54f87
ZU
144
145
4351e719
JP
146# Zeroconf / Avahi Service Discovery ##########################################
147#
148# If this setting is set to "yes", service information will be published with
149# Zeroconf / Avahi.
150#
151#zeroconf_enabled "yes"
aac54f87 152#
4351e719
JP
153# The argument to this setting will be the Zeroconf / Avahi unique name for
154# this MPD server on the network.
155#
156#zeroconf_name "Music Player"
157#
158###############################################################################
159
160
161# Permissions #################################################################
162#
163# If this setting is set, MPD will require password authorization. The password
164# can setting can be specified multiple times for different password profiles.
aac54f87
ZU
165#
166#password "password@read,add,control,admin"
167#
4351e719 168# This setting specifies the permissions a user has who has not yet logged in.
aac54f87
ZU
169#
170#default_permissions "read,add,control,admin"
171#
4351e719 172###############################################################################
aac54f87
ZU
173
174
4351e719 175# Input #######################################################################
aac54f87 176#
4351e719
JP
177
178input {
179 plugin "curl"
180# proxy "proxy.isp.com:8080"
181# proxy_user "user"
182# proxy_password "password"
183}
184
aac54f87 185#
4351e719
JP
186###############################################################################
187
188# Audio Output ################################################################
189#
190# MPD supports various audio output types, as well as playing through multiple
191# audio outputs at the same time, through multiple audio_output settings
192# blocks. Setting this block is optional, though the server will only attempt
193# autodetection for one sound card.
194#
195# See <http://mpd.wikia.com/wiki/Configuration#Audio_Outputs> for examples of
196# other audio outputs.
aac54f87
ZU
197#
198# An example of an ALSA output:
199#
200audio_output {
4351e719
JP
201 type "alsa"
202 name "My ALSA Device"
203## device "hw:0,0" # optional
204## format "44100:16:2" # optional
205## mixer_type "hardware" # optional
206## mixer_device "default" # optional
207## mixer_control "PCM" # optional
208## mixer_index "0" # optional
aac54f87
ZU
209}
210#
211# An example of an OSS output:
212#
213#audio_output {
4351e719
JP
214# type "oss"
215# name "My OSS Device"
216## device "/dev/dsp" # optional
217## format "44100:16:2" # optional
218## mixer_type "hardware" # optional
219## mixer_device "/dev/mixer" # optional
220## mixer_control "PCM" # optional
aac54f87
ZU
221#}
222#
223# An example of a shout output (for streaming to Icecast):
224#
225#audio_output {
4351e719
JP
226# type "shout"
227# encoding "ogg" # optional
228# name "My Shout Stream"
229# host "localhost"
230# port "8000"
231# mount "/mpd.ogg"
232# password "hackme"
233# quality "5.0"
234# bitrate "128"
235# format "44100:16:1"
236## protocol "icecast2" # optional
237## user "source" # optional
238## description "My Stream Description" # optional
239## genre "jazz" # optional
240## public "no" # optional
241## timeout "2" # optional
242## mixer_type "software" # optional
aac54f87
ZU
243#}
244#
4351e719 245# An example of a recorder output:
aac54f87 246#
4351e719
JP
247#audio_output {
248# type "recorder"
249# name "My recorder"
250# encoder "vorbis" # optional, vorbis or lame
251# path "/var/lib/mpd/recorder/mpd.ogg"
252## quality "5.0" # do not define if bitrate is defined
253# bitrate "128" # do not define if quality is defined
254# format "44100:16:1"
255#}
aac54f87 256#
4351e719 257# An example of a httpd output (built-in HTTP streaming server):
aac54f87 258#
4351e719
JP
259#audio_output {
260# type "httpd"
261# name "My HTTP Stream"
262# encoder "vorbis" # optional, vorbis or lame
263# port "8000"
264# bind_to_address "0.0.0.0" # optional, IPv4 or IPv6
265## quality "5.0" # do not define if bitrate is defined
266# bitrate "128" # do not define if quality is defined
267# format "44100:16:1"
268# max_clients "0" # optional 0=no limit
269#}
aac54f87 270#
4351e719 271# An example of a pulseaudio output (streaming to a remote pulseaudio server)
aac54f87 272#
4351e719
JP
273#audio_output {
274# type "pulse"
275# name "My Pulse Output"
276## server "remote_server" # optional
277## sink "remote_server_sink" # optional
278#}
aac54f87 279#
4351e719 280## Example "pipe" output:
aac54f87 281#
4351e719
JP
282#audio_output {
283# type "pipe"
284# name "my pipe"
285# command "aplay -f cd 2>/dev/null"
286## Or if you're want to use AudioCompress
287# command "AudioCompress -m | aplay -f cd 2>/dev/null"
288## Or to send raw PCM stream through PCM:
289# command "nc example.org 8765"
290# format "44100:16:2"
291#}
aac54f87 292#
4351e719 293## An example of a null output (for no audio output):
aac54f87 294#
4351e719
JP
295#audio_output {
296# type "null"
297# name "My Null Output"
298# mixer_type "none" # optional
299#}
aac54f87 300#
4351e719
JP
301# This setting will change all decoded audio to be converted to the specified
302# format before being passed to the audio outputs. By default, this setting is
303# disabled.
aac54f87 304#
4351e719 305#audio_output_format "44100:16:2"
aac54f87 306#
4351e719
JP
307# If MPD has been compiled with libsamplerate support, this setting specifies
308# the sample rate converter to use. Possible values can be found in the
309# mpd.conf man page or the libsamplerate documentation. By default, this is
310# setting is disabled.
aac54f87 311#
4351e719 312#samplerate_converter "Fastest Sinc Interpolator"
aac54f87 313#
4351e719 314###############################################################################
aac54f87
ZU
315
316
4351e719 317# Normalization automatic volume adjustments ##################################
aac54f87 318#
4351e719
JP
319# This setting specifies the type of ReplayGain to use. This setting can have
320# the argument "off", "album" or "track". See <http://www.replaygain.org>
321# for more details. This setting is off by default.
aac54f87 322#
4351e719 323#replaygain "album"
aac54f87 324#
4351e719
JP
325# This setting sets the pre-amp used for files that have ReplayGain tags. By
326# default this setting is disabled.
aac54f87 327#
4351e719 328#replaygain_preamp "0"
aac54f87 329#
4351e719
JP
330# This setting enables on-the-fly normalization volume adjustment. This will
331# result in the volume of all playing audio to be adjusted so the output has
332# equal "loudness". This setting is disabled by default.
aac54f87 333#
4351e719 334#volume_normalization "no"
aac54f87 335#
4351e719 336###############################################################################
aac54f87
ZU
337
338
4351e719 339# MPD Internal Buffering ######################################################
aac54f87 340#
4351e719
JP
341# This setting adjusts the size of internal decoded audio buffering. Changing
342# this may have undesired effects. Don't change this if you don't know what you
343# are doing.
aac54f87 344#
4351e719 345#audio_buffer_size "2048"
aac54f87 346#
4351e719
JP
347# This setting controls the percentage of the buffer which is filled before
348# beginning to play. Increasing this reduces the chance of audio file skipping,
349# at the cost of increased time prior to audio playback.
aac54f87 350#
4351e719 351#buffer_before_play "10%"
aac54f87 352#
4351e719 353###############################################################################
aac54f87
ZU
354
355
4351e719 356# Resource Limitations ########################################################
aac54f87 357#
4351e719
JP
358# These settings are various limitations to prevent MPD from using too many
359# resources. Generally, these settings should be minimized to prevent security
360# risks, depending on the operating resources.
aac54f87 361#
4351e719
JP
362#connection_timeout "60"
363#max_connections "10"
364#max_playlist_length "16384"
365#max_command_list_size "2048"
366#max_output_buffer_size "8192"
aac54f87 367#
4351e719 368###############################################################################
aac54f87
ZU
369
370
4351e719 371# Character Encoding ##########################################################
aac54f87 372#
4351e719
JP
373# If file or directory names do not display correctly for your locale then you
374# may need to modify this setting.
aac54f87 375#
4351e719 376filesystem_charset "UTF-8"
aac54f87 377#
4351e719 378# This setting controls the encoding that ID3v1 tags should be converted from.
aac54f87 379#
4351e719 380#id3v1_encoding "ISO-8859-1"
aac54f87 381#
4351e719
JP
382###############################################################################
383
384
385# SIDPlay decoder #############################################################
386#
387# songlength_database:
388# Location of your songlengths file, as distributed with the HVSC.
389# The sidplay plugin checks this for matching MD5 fingerprints.
390# See http://www.c64.org/HVSC/DOCUMENTS/Songlengths.faq
391#
392# default_songlength:
393# This is the default playing time in seconds for songs not in the
394# songlength database, or in case you're not using a database.
395# A value of 0 means play indefinitely.
396#
397# filter:
398# Turns the SID filter emulation on or off.
399#
400#decoder {
401# plugin "sidplay"
402# songlength_database "/media/C64Music/DOCUMENTS/Songlengths.txt"
403# default_songlength "120"
404# filter "true"
405#}
aac54f87 406#
4351e719
JP
407###############################################################################
408
This page took 0.121963 seconds and 4 git commands to generate.