Audio outputs are devices which actually play the audio chunks produced by MPD. You can configure any number of audio output devices, but there must be at least one. If none is configured, MPD attempts to auto-detect. Usually, this works quite well with ALSA, OSS and on Mac OS X.
To configure an audio output manually, add an
audio_output
block to
mpd.conf
:
audio_output { type "alsa" name "my ALSA device" device "hw:0" }
The following table lists the audio_output
options valid for all plugins:
Name | Description |
---|---|
type
| The name of the plugin. |
name
| The name of the audio output. It is visible to the client. Some plugins also use it internally, e.g. as a name registered in the PULSE server. |
format
|
Always open the audio output with the specified audio format (samplerate:bits:channels), regardless of the format of the input file. This is optional for most plugins.
Any of the three attributes may be an asterisk to
specify that this attribute should not be enforced,
example:
The following values are valid for
|
enabled
yes|no
| Specifies whether this audio output is enabled when MPD is started. By default, all audio outputs are enabled. |
tags
yes|no
|
If set to no , then
MPD will not send tags to
this output. This is only useful for output plugins
that can receive tags, for example the httpd
output plugin.
|
always_on
yes|no
|
If set to yes , then
MPD attempts to keep this
audio output always open. This may be useful for
streaming servers, when you don't want to disconnect
all listeners even when playback is accidentally
stopped.
|
mixer_type
hardware|software|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 others.
|
replay_gain_handler
software|mixer|none
|
Specifies how replay gain is applied. The default is
software , which uses an
internal software volume control.
mixer uses the configured
(hardware) mixer control. none
disables replay gain on this audio output.
|