Plugin reference

Database plugins

simple

The default plugin. Stores a copy of the database in memory. A file is used for permanent storage.

Setting Description
path The path of the database file.
cache_directory The path of the cache directory for additional storages mounted at runtime. This setting is necessary for the mount protocol command.
compress yes|no Compress the database file using gzip? Enabled by default (if built with zlib).

proxy

Provides access to the database of another MPD instance using libmpdclient. This is useful when you run mount the music directory via NFS/SMB, and the file server already runs a MPD instance. Only the file server needs to update the database.

Setting Description
host The host name of the “master” MPD instance.
port The port number of the “master” MPD instance.
password The password used to log in to the “master” MPD instance.
keepalive yes|no Send TCP keepalive packets to the “master” MPD instance? This option can help avoid certain firewalls dropping inactive connections, at the expensive of a very small amount of additional network traffic. Disabled by default.

upnp

Provides access to UPnP media servers.

Storage plugins

local

The default plugin which gives MPD access to local files. It is used when music_directory refers to a local directory.

curl

A WebDAV client using libcurl. It is used when music_directory contains a http:// or https:// URI, for example https://the.server/dav/.

smbclient

Load music files from a SMB/CIFS server. It is used when music_directory contains a smb:// URI, for example smb://myfileserver/Music.

nfs

Load music files from a NFS server. It is used when music_directory contains a nfs:// URI according to RFC2224, for example nfs://servername/path.

This plugin uses libnfs, which supports only NFS version 3. Since MPD is not allowed to bind to “privileged ports”, the NFS server needs to enable the “insecure” setting; example /etc/exports:

/srv/mp3 192.168.1.55(ro,insecure)

Don’t fear: “insecure” does not mean that your NFS server is insecure. A few decades ago, people thought the concept of “privileged ports” would make network services “secure”, which was a fallacy. The absence of this obsolete “security” measure means little.

udisks

Mount file systems (e.g. USB sticks or other removable media) using the udisks2 daemon via D-Bus. To obtain a valid udisks2 URI, consult the according neighbor plugin.

It might be necessary to grant MPD privileges to control udisks2 through policykit. To do this, create a file called /usr/share/polkit-1/rules.d/mpd-udisks.rules with the following text:

polkit.addRule(function(action, subject) {
  if ((action.id == "org.freedesktop.udisks2.filesystem-mount" ||
       action.id == "org.freedesktop.udisks2.filesystem-mount-other-seat") &&
      subject.user == "mpd") {
      return polkit.Result.YES;
  }
});

If you run MPD as a different user, change mpd to the name of your MPD user.

Neighbor plugins

smbclient

Provides a list of SMB/CIFS servers on the local network.

udisks

Queries the udisks2 daemon via D-Bus and obtain a list of file systems (e.g. USB sticks or other removable media).

upnp

Provides a list of UPnP servers on the local network.

Input plugins

alsa

Allows MPD on Linux to play audio directly from a soundcard using the scheme alsa://. Audio is by default formatted as 48 kHz 16-bit stereo, but this default can be overidden by a config file setting or by the URI. Examples:

mpc add alsa:// plays audio from device default
mpc add alsa://hw:1,0 plays audio from device hw:1,0
mpc add alsa://hw:1,0?format=44100:16:2 plays audio from device hw:1,0 sampling 16-bit stereo at 44.1kHz.
Setting Description
default_device NAME The alsa device id to use to none is specified in the uri.
default_format F

The sampling rate, size and channels to use. Wildcards are not allowed.

Example - “44100:16:2”

auto_resample yes|no If set to no, then libasound will not attempt to resample. In this case, the user is responsible for ensuring that the requested sample rate can be produced natively by the device, otherwise an error will occur.
auto_channels yes|no If set to no, then libasound will not attempt to convert between different channel numbers. The user must ensure that the device supports the requested channels when sampling.
auto_format yes|no If set to no, then libasound will not attempt to convert between different sample formats (16 bit, 24 bit, floating point, …). Again the user must ensure that the requested format is available natively from the device.

cdio_paranoia

Plays audio CDs using libcdio. The URI has the form: “cdda://[DEVICE][/TRACK]”. The simplest form cdda:// plays the whole disc in the default drive.

Setting Description
default_byte_order little_endian|big_endian If the CD drive does not specify a byte order, MPD assumes it is the CPU’s native byte order. This setting allows overriding this.
speed N Request CDParanoia cap the extraction speed to Nx normal CD audio rotation speed, keeping the drive quiet.

curl

Opens remote files or streams over HTTP using libcurl.

Note that unless overridden by the below settings (e.g. by setting them to a blank value), general curl configuration from environment variables such as http_proxy or specified in ~/.curlrc will be in effect.

Setting Description
proxy Sets the address of the HTTP proxy server.
proxy_user, proxy_password Configures proxy authentication.
verify_peer yes|no Verify the peer’s SSL certificate? More information.
verify_host yes|no Verify the certificate’s name against host? More information.

ffmpeg

Access to various network protocols implemented by the FFmpeg library: gopher://, rtp://, rtsp://, rtmp://, rtmpt://, rtmps://

file

Opens local files

mms

Plays streams with the MMS protocol using libmms.

nfs

Allows MPD to access files on NFSv3 servers without actually mounting them (i.e. in userspace, without help from the kernel’s VFS layer). All URIs with the nfs:// scheme are used according to RFC2224. Example:

mpc add nfs://servername/path/filename.ogg

Note that this usually requires enabling the “insecure” flag in the server’s /etc/exports file, because MPD cannot bind to so-called “privileged” ports. Don’t fear: this will not make your file server insecure; the flag was named in a time long ago when privileged ports were thought to be meaningful for security. By today’s standards, NFSv3 is not secure at all, and if you believe it is, you’re already doomed.

smbclient

Allows MPD to access files on SMB/CIFS servers (e.g. Samba or Microsoft Windows). All URIs with the smb:// scheme are used. Example:

mpc add smb://servername/sharename/filename.ogg

qobuz

Play songs from the commercial streaming service Qobuz. It plays URLs in the form qobuz://track/ID, e.g.:

mpc add qobuz://track/23601296
Setting Description
app_id ID The Qobuz application id.
app_secret SECRET The Qobuz application secret.
username USERNAME The Qobuz user name.
password PASSWORD The Qobuz password.
format_id N The Qobuz format identifier, i.e. a number which chooses the format and quality to be requested from Qobuz. The default is “5” (320 kbit/s MP3).

tidal

Play songs from the commercial streaming service Tidal. It plays URLs in the form tidal://track/ID, e.g.:

Warning

This plugin is currently defunct because Tidal has changed the protocol and decided not to share documentation.

mpc add tidal://track/59727857
Setting Description
token TOKEN The Tidal application token. Since Tidal is unwilling to assign a token to MPD, this needs to be reverse-engineered from another (approved) Tidal client.
username USERNAME The Tidal user name.
password PASSWORD The Tidal password.
audioquality Q The Tidal “audioquality” parameter. Possible values: HI_RES, LOSSLESS, HIGH, LOW. Default is HIGH.

Decoder plugins

adplug

Decodes AdLib files using libadplug.

Setting Description
sample_rate The sample rate that shall be synthesized by the plugin. Defaults to 48000.

audiofile

Decodes WAV and AIFF files using libaudiofile.

faad

Decodes AAC files using libfaad.

ffmpeg

Decodes various codecs using FFmpeg.

Setting Description
analyzeduration VALUE Sets the FFmpeg muxer option analyzeduration, which specifies how many microseconds are analyzed to probe the input. The FFmpeg formats documentation has more information.
probesize VALUE Sets the FFmpeg muxer option probesize, which specifies probing size in bytes, i.e. the size of the data to analyze to get stream information. The FFmpeg formats documentation has more information.

flac

Decodes FLAC files using libFLAC.

dsdiff

Decodes DFF files containing DSDIFF data (e.g. SACD rips).

Setting Description
lsbitfirst yes|no Decode the least significant bit first. Default is no.

dsf

Decodes DSF files containing DSDIFF data (e.g. SACD rips).

fluidsynth

MIDI decoder based on FluidSynth.

Setting Description
sample_rate The sample rate that shall be synthesized by the plugin. Defaults to 48000.
soundfont The absolute path of the soundfont file. Defaults to /usr/share/sounds/sf2/FluidR3_GM.sf2.

gme

Video game music file emulator based on game-music-emu.

Setting Description
accuracy yes|no Enable more accurate sound emulation.

hybrid_dsd

Hybrid-DSD is a MP4 container file (*.m4a) which contains both ALAC and DSD data. It is disabled by default, and works only if you explicitly enable it. Without this plugin, the ALAC parts gets handled by the FFmpeg decoder plugin. This plugin should be enabled only if you have a bit-perfect playback path to a DSD-capable DAC; for everybody else, playing back the ALAC copy of the file is better.

mad

Decodes MP3 files using libmad.

mikmod

Module player based on MikMod.

Setting Description
loop yes|no Allow backward loops in modules. Default is no.
sample_rate Sets the sample rate generated by libmikmod. Default is 44100.

modplug

Module player based on MODPlug.

Setting Description
loop_count Number of times to loop the module if it uses backward loops. Default is 0 which prevents looping. -1 loops forever.

mpcdec

Decodes Musepack files using libmpcdec.

mpg123

Decodes MP3 files using libmpg123.

opus

Decodes Opus files using libopus.

pcm

Read raw PCM samples. It understands the “audio/L16” MIME type with parameters “rate” and “channels” according to RFC 2586. It also understands the MPD-specific MIME type “audio/x-mpd-float”.

sidplay

C64 SID decoder based on libsidplayfp or libsidplay2.

Setting Description
songlength_database PATH Location of your songlengths file, as distributed with the HVSC. The sidplay plugin checks this for matching MD5 fingerprints. See http://www.hvsc.c64.org/download/C64Music/DOCUMENTS/Songlengths.faq.
default_songlength SECONDS This is the default playing time in seconds for songs not in the songlength database, or in case you’re not using a database. A value of 0 means play indefinitely.
default_genre GENRE Optional default genre for SID songs.
filter yes|no Turns the SID filter emulation on or off.
kernal Only libsidplayfp. Roms are not embedded in libsidplayfp - please note https://sourceforge.net/p/sidplay-residfp/news/2013/01/released-libsidplayfp-100beta1/ But some SID tunes require rom images to play. Make C64 rom dumps from your own vintage gear or use rom files from Frodo or VICE emulation software tarballs. Absolute path to kernal rom image file.
basic Only libsidplayfp. Absolute path to basic rom image file.

sndfile

Decodes WAV and AIFF files using libsndfile.

vorbis

Decodes Ogg-Vorbis files using libvorbis.

wavpack

Decodes WavPack files using libwavpack.

wildmidi

MIDI decoder based on libwildmidi.

Setting Description
config_file The absolute path of the timidity config file. Defaults to /etc/timidity/timidity.cfg.

Encoder plugins

flac

Encodes into FLAC (lossless).

Setting Description
compression Sets the libFLAC compression level. The levels range from 0 (fastest, least compression) to 8 (slowest, most compression).

lame

Encodes into MP3 using the LAME library.

Setting Description
quality Sets the quality for VBR. 0 is the highest quality, 9 is the lowest quality. Cannot be used with bitrate.
bitrate Sets the bit rate in kilobit per second. Cannot be used with quality.

null

Does not encode anything, passes the input PCM data as-is.

shine

Encodes into MP3 using the Shine library.

Setting Description
bitrate Sets the bit rate in kilobit per second.

twolame

Encodes into MP2 using the TwoLAME library.

Setting Description
quality Sets the quality for VBR. 0 is the highest quality, 9 is the lowest quality. Cannot be used with bitrate.
bitrate Sets the bit rate in kilobit per second. Cannot be used with quality.

opus

Encodes into Ogg Opus.

Setting Description
bitrate Sets the data rate in bit per second. The special value “auto” lets libopus choose a rate (which is the default), and “max” uses the maximum possible data rate.
complexity Sets the Opus complexity.
signal Sets the Opus signal type. Valid values are “auto” (the default), “voice” and “music”.
opustags yes|no Configures how metadata is interleaved into the stream. If set to yes, then metadata is inserted using ogg stream chaining, as specified in RFC 7845. If set to no (the default), then ogg stream chaining is avoided and other output-dependent method is used, if available.

vorbis

Encodes into Ogg Vorbis.

Setting Description
quality Sets the quality for VBR. -1 is the lowest quality, 10 is the highest quality. Defaults to 3. Cannot be used with bitrate.
bitrate Sets the bit rate in kilobit per second. Cannot be used with quality.

wave

Encodes into WAV (lossless).

Resampler plugins

The resampler can be configured in a block named resampler, for example:

resampler {
  plugin "soxr"
  quality "very high"
}

The following table lists the resampler options valid for all plugins:

Name Description
plugin The name of the plugin.

internal

A resampler built into MPD. Its quality is very poor, but its CPU usage is low. This is the fallback if MPD was compiled without an external resampler.

libsamplerate

A resampler using libsamplerate a.k.a. Secret Rabbit Code (SRC).

Name Description
type The interpolator type. See below for a list of known types.

The following converter types are provided by libsamplerate:

Type Description
“Best Sinc Interpolator” or “0” Band limited sinc interpolation, best quality, 97dB SNR, 96% BW.
“Medium Sinc Interpolator” or “1” Band limited sinc interpolation, medium quality, 97dB SNR, 90% BW.
“Fastest Sinc Interpolator” or “2” Band limited sinc interpolation, fastest, 97dB SNR, 80% BW.
“ZOH Sinc Interpolator” or “3” Zero order hold interpolator, very fast, very poor quality with audible distortions.
“Linear Interpolator” or “4” Linear interpolator, very fast, poor quality.

soxr

A resampler using libsoxr, the SoX Resampler library

Name Description
quality The libsoxr quality setting. Valid values see below.
threads The number of libsoxr threads. “0” means “automatic”. The default is “1” which disables multi-threading.

Valid quality values for libsoxr:

  • “very high”
  • “high” (the default)
  • “medium”
  • “low”
  • “quick”

Output plugins

alsa

The Advanced Linux Sound Architecture (ALSA) plugin uses libasound. It is recommended if you are using Linux.

Setting Description
device NAME Sets the device which should be used. This can be any valid ALSA device name. The default value is “default”, which makes libasound choose a device. It is recommended to use a “hw” or “plughw” device, because otherwise, libasound automatically enables “dmix”, which has major disadvantages (fixed sample rate, poor resampler, …).
buffer_time US Sets the device’s buffer time in microseconds. Don’t change unless you know what you’re doing.
period_time US Sets the device’s period time in microseconds. Don’t change unless you really know what you’re doing.
auto_resample yes|no If set to no, then libasound will not attempt to resample, handing the responsibility over to MPD. It is recommended to let MPD resample (with libsamplerate), because ALSA is quite poor at doing so.
auto_channels yes|no If set to no, then libasound will not attempt to convert between different channel numbers.
auto_format yes|no If set to no, then libasound will not attempt to convert between different sample formats (16 bit, 24 bit, floating point, …).
dop yes|no If set to yes, then DSD over PCM according to the DoP standard is enabled. This wraps DSD samples in fake 24 bit PCM, and is understood by some DSD capable products, but may be harmful to other hardware. Therefore, the default is no and you can enable the option at your own risk.
allowed_formats F1 F2 …

Specifies a list of allowed audio formats, separated by a space. All items may contain asterisks as a wild card, and may be followed by “=dop” to enable DoP (DSD over PCM) for this particular format. The first matching format is used, and if none matches, MPD chooses the best fallback of this list.

Example: “96000:16:* 192000:24:* dsd64:=dop *:dsd:”.

The according hardware mixer plugin understands the following settings:

Setting Description
mixer_device DEVICE Sets the ALSA mixer device name, defaulting to default which lets ALSA pick a value.
mixer_control NAME Choose a mixer control, defaulting to PCM. Type amixer scontrols to get a list of available mixer controls.
mixer_index NUMBER Choose a mixer control index. This is necessary if there is more than one control with the same name. Defaults to 0 (the first one).

The following attributes can be configured at runtime using the outputset command:

Setting Description
dop 1|0 Allows changing the dop configuration setting at runtime. This takes effect the next time the output is opened.
allowed_formats F1 F2 … Allows changing the allowed_formats configuration setting at runtime. This takes effect the next time the output is opened.

ao

The ao plugin uses the portable libao library. Use only if there is no native plugin for your operating system.

Setting Description
driver D The libao driver to use for audio output. Possible values depend on what libao drivers are available. See http://www.xiph.org/ao/doc/drivers.html for information on some commonly used drivers. Typical values for Linux include “oss” and “alsa09”. The default is “default”, which causes libao to select an appropriate plugin.
options O Options to pass to the selected libao driver.
write_size O This specifies how many bytes to write to the audio device at once. This parameter is to work around a bug in older versions of libao on sound cards with very small buffers. The default is 1024.

sndio

The sndio plugin uses the sndio library. It should normally be used on OpenBSD.

Setting Description
device NAME The audio output device libsndio will attempt to use. The default is “default” which causes libsndio to select the first output device.
buffer_time MS Set the application buffer time in milliseconds.

fifo

The fifo plugin writes raw PCM data to a FIFO (First In, First Out) file. The data can be read by another program.

Setting Description
path P This specifies the path of the FIFO to write to. Must be an absolute path. If the path does not exist, it will be created when MPD is started, and removed when MPD is stopped. The FIFO will be created with the same user and group as MPD is running as. Default permissions can be modified by using the builtin shell command umask. If a FIFO already exists at the specified path it will be reused, and will not be removed when MPD is stopped. You can use the “mkfifo” command to create this, and then you may modify the permissions to your liking.

haiku

Use the SoundPlayer API on the Haiku operating system.

This plugin is unmaintained and contains known bugs. It will be removed soon, unless there is a new maintainer.

jack

The jack plugin connects to a JACK server.

Setting Description
client_name NAME The name of the JACK client. Defaults to “Music Player Daemon”.
server_name NAME Optional name of the JACK server.
autostart yes|no If set to yes, then libjack will automatically launch the JACK daemon. Disabled by default.
source_ports A,B The names of the JACK source ports to be created. By default, the ports “left” and “right” are created. To use more ports, you have to tweak this option.
destination_ports A,B The names of the JACK destination ports to connect to.
auto_destination_ports yes|no If set to yes, then MPD will automatically create connections between the send ports of MPD and receive ports of the first sound card; if set to no, then MPD will only create connections to the contents of destination_ports if it is set. Enabled by default.
ringbuffer_size NBYTES Sets the size of the ring buffer for each channel. Do not configure this value unless you know what you’re doing.

httpd

The httpd plugin creates a HTTP server, similar to ShoutCast / IceCast. HTTP streaming clients like mplayer, VLC, and mpv can connect to it.

It is highly recommended to configure a fixed format, because a stream cannot switch its audio format on-the-fly when the song changes.

Setting Description
port P Binds the HTTP server to the specified port.
bind_to_address ADDR Binds the HTTP server to the specified address (IPv4, IPv6 or local socket). Multiple addresses in parallel are not supported.
encoder NAME Chooses an encoder plugin. A list of encoder plugins can be found in the encoder plugin reference Encoder plugins.
max_clients MC Sets a limit, number of concurrent clients. When set to 0 no limit will apply.

null

The null plugin does nothing. It discards everything sent to it.

Setting Description
sync yes|no If set to no, then the timer is disabled - the device will accept PCM chunks at arbitrary rate (useful for benchmarking). The default behaviour is to play in real time.

oss

The “Open Sound System” plugin is supported on most Unix platforms.

On Linux, OSS has been superseded by ALSA. Use the ALSA output plugin alsa instead of this one on Linux.

Setting Description
device PATH Sets the path of the PCM device. If not specified, then MPD will attempt to open /dev/sound/dsp and /dev/dsp.

The according hardware mixer plugin understands the following settings:

Setting Description
mixer_device DEVICE Sets the OSS mixer device path, defaulting to /dev/mixer.
mixer_control NAME Choose a mixer control, defaulting to PCM.

openal

The “OpenAL” plugin uses libopenal. It is supported on many platforms. Use only if there is no native plugin for your operating system.

Setting Description
device NAME Sets the device which should be used. This can be any valid OpenAL device name. If not specified, then libopenal will choose a default device.

osx

The “Mac OS X” plugin uses Apple’s CoreAudio API.

Setting Description
device NAME Sets the device which should be used. Uses device names as listed in the “Audio Devices” window of “Audio MIDI Setup”.
hog_device yes|no Hog the device. This means that it takes exclusive control of the audio output device it is playing through, and no other program can access it.
dop yes|no If set to yes, then DSD over PCM according to the DoP standard is enabled. This wraps DSD samples in fake 24 bit PCM, and is understood by some DSD capable products, but may be harmful to other hardware. Therefore, the default is no and you can enable the option at your own risk. Under macOS you must make sure to select a physical mode on the output device which supports at least 24 bits per channel as the Mac OS X plugin only changes the sample rate.
channel_map SOURCE,SOURCE,…

Specifies a channel map. If your audio device has more than two outputs this allows you to route audio to auxillary outputs. For predictable results you should also specify a “format” with a fixed number of channels, e.g. “::2”. The number of items in the channel map must match the number of output channels of your output device. Each list entry specifies the source for that output channel; use “-1” to silence an output. For example, if you have a four-channel output device and you wish to send stereo sound (format “::2”) to outputs 3 and 4 while leaving outputs 1 and 2 silent then set the channel map to “-1,-1,0,1”. In this example ‘0’ and ‘1’ denote the left and right channel respectively.

The channel map may not refer to outputs that do not exist according to the format. If the format is “::1” (mono) and you have a four-channel sound card then “-1,-1,0,0” (dual mono output on the second pair of sound card outputs) is a valid channel map but “-1,-1,0,1” is not because the second channel (‘1’) does not exist when the output is mono.

pipe

The pipe plugin starts a program and writes raw PCM data into its standard input.

Setting Description
command CMD This command is invoked with the shell.

pulse

The pulse plugin connects to a PulseAudio server. Requires libpulse.

Setting Description
server HOSTNAME Sets the host name of the PulseAudio server. By default, MPD connects to the local PulseAudio server.
sink NAME Specifies the name of the PulseAudio sink MPD should play on.
media_role ROLE Specifies a custom media role that MPD reports to PulseAudio. Default is “music”. (optional).
scale_volume FACTOR Specifies a linear scaling coefficient (ranging from 0.5 to 5.0) to apply when adjusting volume through MPD. For example, chosing a factor equal to "0.7" means that setting the volume to 100 in MPD will set the PulseAudio volume to 70%, and a factor equal to "3.5" means that volume 100 in MPD corresponds to a 350% PulseAudio volume.

recorder

The recorder plugin writes the audio played by MPD to a file. This may be useful for recording radio streams.

Setting Description
path P Write to this file.
format_path P An alternative to path which provides a format string referring to tag values. The special tag iso8601 emits the current date and time in ISO8601 format (UTC). Every time a new song starts or a new tag gets received from a radio station, a new file is opened. If the format does not render a file name, nothing is recorded. A tag name enclosed in percent signs (‘%’) is replaced with the tag value. Example: -/.mpd/recorder/%artist% - %title%.ogg. Square brackets can be used to group a substring. If none of the tags referred in the group can be found, the whole group is omitted. Example: [-/.mpd/recorder/[%artist% - ]%title%.ogg] (this omits the dash when no artist tag exists; if title also doesn’t exist, no file is written). The operators “|” (logical “or”) and “&” (logical “and”) can be used to select portions of the format string depending on the existing tag values. Example: -/.mpd/recorder/[%title%|%name%].ogg (use the “name” tag if no title exists)
encoder NAME Chooses an encoder plugin. A list of encoder plugins can be found in the encoder plugin reference Encoder plugins.

shout

The shout plugin connects to a ShoutCast or IceCast server using libshout. It forwards tags to this server.

You must set a format.

Setting Description
host HOSTNAME Sets the host name of the ShoutCast / IceCast server.
port PORTNUMBER Connect to this port number on the specified host.
timeout SECONDS Set the timeout for the shout connection in seconds. Defaults to 2 seconds.
protocol icecast2|icecast1|shoutcast Specifies the protocol that wil be used to connect to the server. The default is “icecast2”.
tls disabled|auto|auto_no_plain|rfc2818|rfc2817 Specifies what kind of TLS to use. The default is “disabled” (no TLS).
mount URI Mounts the MPD stream in the specified URI.
user USERNAME Sets the user name for submitting the stream to the server. Default is “source”.
password PWD Sets the password for submitting the stream to the server.
name NAME Sets the name of the stream.
genre GENRE Sets the genre of the stream (optional).
description DESCRIPTION Sets a short description of the stream (optional).
url URL Sets a URL associated with the stream (optional).
public yes|no Specifies whether the stream should be “public”. Default is no.
encoder PLUGIN Chooses an encoder plugin. Default is vorbis vorbis. A list of encoder plugins can be found in the encoder plugin reference Encoder plugins.

sles

Plugin using the OpenSL ES audio API. Its primary use is local playback on Android, where ALSA is not available.

solaris

The “Solaris” plugin runs only on SUN Solaris, and plays via /dev/audio.

Setting Description
device PATH Sets the path of the audio device, defaults to /dev/audio.

Filter plugins

ffmpeg

Configures a FFmpeg filter graph.

This plugin requires building with libavfilter (FFmpeg).

Setting Description
graph “…” Specifies the libavfilter graph; read the FFmpeg documentation for details

hdcd

Decode HDCD.

This plugin requires building with libavfilter (FFmpeg).

normalize

Normalize the volume during playback (at the expensve of quality).

null

A no-op filter. Audio data is returned as-is.

route

Reroute channels.

Setting Description
routes “0>0, 1>1, …” Specifies the channel mapping.

Playlist plugins

asx

Reads .asx playlist files.

cue

Reads .cue files.

embcue

Reads CUE sheets from the “CUESHEET” tag of song files.

m3u

Reads .m3u playlist files.

extm3u

Reads extended .m3u playlist files.

flac

Reads the cuesheet metablock from a FLAC file.

pls

Reads .pls playlist files.

rss

Reads music links from .rss files.

soundcloud

Download playlist from SoundCloud. It accepts URIs starting with soundcloud://.

Setting Description
apikey KEY An API key to access the SoundCloud servers.

xspf

Reads XSPF playlist files.