Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
mpd.conf(5)		      File Formats Manual		   mpd.conf(5)

       musicpd.conf - Music Player Daemon configuration	file

       mpd.conf	is the configuration file for mpd(1).  If not specified	on the
       command	 line,	 MPD   first   searches	  for	 it    at    $XDG_CON-
       FIG_HOME/mpd/mpd.conf  then  at	~/.mpdconf then	at ~/.mpd/mpd.conf and
       then in /etc/mpd.conf.

       Lines beginning with a "#" character are	comments.  All other non-empty
       lines specify parameters	and their values.  These lines contain the pa-
       rameter name and	parameter value	(surrounded by	double	quotes)	 sepa-
       rated by	whitespace (either tabs	or spaces).  For example:

       parameter "value"

       The  exception  to this rule is the audio_output	parameter, which is of
       the form:

       audio_output {
	       parameter1 "value"
	       parameter2 "value"

       Parameters that take a file or directory	as an argument should use  ab-
       solute paths.

       See  docs/mpdconf.example in the	source tarball for an example configu-
       ration file.

       This manual is not complete, it lists only the most important  options.
       Please  read  the  MPD  user manual for a complete configuration	guide:

       db_file <file>
	      This specifies where the db file will be stored.

       log_file	<file>
	      This specifies where the log file	should be located.   The  spe-
	      cial value "syslog" makes	MPD use	the local syslog daemon.

       sticker_file <file>
	      The  location of the sticker database.  This is a	database which
	      manages dynamic information attached to songs.

       pid_file	<file>
	      This specifies the file to save mpd's process ID in.

       music_directory <directory>
	      This specifies the directory where music is located.  If you  do
	      not configure this, you can only play streams.

       playlist_directory <directory>
	      This  specifies  the directory where saved playlists are stored.
	      If you do	not configure this, you	cannot save playlists.

       state_file <file>
	      This specifies if	a state	file is	used and where it is  located.
	      The  state  of mpd will be saved to this file when mpd is	termi-
	      nated by a TERM signal or	by the "kill" command.	 When  mpd  is
	      restarted,  it will read the state file and restore the state of
	      mpd (including the playlist).

       restore_paused <yes or no>
	      Put MPD into pause  mode	instead	 of  starting  playback	 after

       user <username>
	      This  specifies  the  user  that	MPD  will run as, if set.  MPD
	      should never run as root,	and you	may use	this  option  to  make
	      MPD  change  its	user id	after initialization.  Do not use this
	      option if	you start MPD as an unprivileged user.

       port <port>
	      This specifies the port that mpd listens	on.   The  default  is

       log_level <default, secure, or verbose>
	      This  specifies how verbose logs are.  "default" is minimal log-
	      ging, "secure" reports from what address a connection is opened,
	      and  when	 it is closed, and "verbose" records excessive amounts
	      of information for debugging  purposes.	The  default  is  "de-

       follow_outside_symlinks <yes or no>
	      Control  if  MPD will follow symbolic links pointing outside the
	      music dir.  You must recreate the	database after	changing  this
	      option.  The default is "yes".

       follow_inside_symlinks <yes or no>
	      Control  if  MPD	will follow symbolic links pointing inside the
	      music dir, potentially adding duplicates to the  database.   You
	      must  recreate the database after	changing this option.  The de-
	      fault is "yes".

       zeroconf_enabled	<yes or	no>
	      If yes, and MPD has been compiled	with support for Avahi or Bon-
	      jour,  service information will be published with	Zeroconf.  The
	      default is yes.

       zeroconf_name <name>
	      If Zeroconf is enabled, this is the  service  name  to  publish.
	      This  name should	be unique to your local	network, but name col-
	      lisions will be properly dealt  with.   The  default  is	"Music
	      Player @ %h", where %h will be replaced with the hostname	of the
	      machine running MPD.

	      See DESCRIPTION and the various AUDIO OUTPUT PARAMETERS sections
	      for  the	format	of this	parameter.  Multiple audio_output sec-
	      tions may	be specified.  If no audio_output  section  is	speci-
	      fied, then MPD will scan for a usable audio output.

       replaygain <off or album	or track or auto>
	      If  specified,  mpd will adjust the volume of songs played using
	      ReplayGain  tags	(see  <>).   Setting
	      this  to "album" will adjust volume using	the album's ReplayGain
	      tags, while setting it to	"track"	will adjust it using the track
	      ReplayGain  tags.	 "auto"	uses the track ReplayGain tags if ran-
	      dom play is activated otherwise the album	ReplayGain tags.  Cur-
	      rently  only  FLAC, Ogg Vorbis, Musepack,	and MP3	(through ID3v2
	      ReplayGain tags, not APEv2) are supported.

       replaygain_preamp <-15 to 15>
	      This is the gain (in dB) applied to songs	with ReplayGain	tags.

       volume_normalization <yes or no>
	      If yes, mpd will normalize the volume of	songs  as  they	 play.
	      The default is no.

       filesystem_charset <charset>
	      This  specifies  the  character  set used	for the	filesystem.  A
	      list of supported	character sets	can  be	 obtained  by  running
	      "iconv  -l".  The	default	is determined from the locale when the
	      db was originally	created.

       save_absolute_paths_in_playlists	<yes or	no>
	      This specifies whether relative or absolute paths	for song file-
	      names are	used when saving playlists.  The default is "no".

       auto_update <yes	or no>
	      This  specifies the whether to support automatic update of music
	      database when files are changed in music_directory. The  default
	      is to disable autoupdate of database.

       auto_update_depth <N>
	      Limit  the  depth	of the directories being watched, 0 means only
	      watch the	music directory	itself.	 There is no limit by default.

       type <type>
	      This specifies the audio output type.  See the list of supported
	      outputs in mpd --version for possible values.

       name <name>
	      This specifies a unique name for the audio output.

       format <sample_rate:bits:channels>
	      This  specifies  the sample rate,	bits per sample, and number of
	      channels of audio	that is	sent to	the audio output device.   See
	      documentation for	the audio_output_format	parameter for more de-
	      tails.  The default is to	use whatever audio format is passed to
	      the  audio output.  Any of the three attributes may be an	aster-
	      isk to specify that this attribute should	not be enforced

       replay_gain_handler <software, mixer or none>
	      Specifies	how replay gain	is applied.   The  default  is	"soft-
	      ware",  which uses an internal software volume control.  "mixer"
	      uses the configured (hardware) mixer control.   "none"  disables
	      replay gain on this audio	output.

       mixer_type <hardware, software or none>
	      Specifies	 which mixer should be used for	this audio output: the
	      hardware mixer (available	for ALSA,  OSS	and  PulseAudio),  the
	      software	mixer  or no mixer ("none").  By default, the hardware
	      mixer is used for	devices	which support it,  and	none  for  the

	      User configuration file.

	      Global configuration file.

       musicpd(1), mpc(1)



Want to link to this manual page? Use this URL:

home | help