mpd(1)

mpd1

Mpd documentation

Usage

mpd [options] [CONF_FILE]

Overview

MPD is a daemon for playing music. Music is played through the configured audio output(s) (which are generally local, but can be remote). The daemon stores info about all available music, and this info can be easily searched and retrieved. Player control, info retrieval, and playlist management can all be managed remotely.

MPD searches for a config file in $XDG_CONFIG_HOME/mpd/mpd.conf then ~/.mpdconf then ~/.mpd/mpd.conf then /etc/mpd.conf or uses CONF_FILE.

Read more about MPD at <http://www.musicpd.org/>

Options

--help

Output a brief help message.

--kill

Kill the currently running mpd session. The pid_file parameter must be specified in the config file for this to work.

--no-config

Don't read from the configuration file.

--no-daemon

Don't detach from console.

--stderr

Print messages to stderr.

--systemd

Used on Linux only so MPD can reliably detect whether it was started as a systemd service. Users shouldn't use this switch on the command line.

--verbose

Verbose logging.

--version

Print version information.

Files

$XDG_CONFIG_HOME/mpd/mpd.conf

User configuration file (usually ~/.config/mpd/mpd.conf).

/etc/mpd.conf

Global configuration file.

Releases

12 releases since Debian 3.1 (Sarge); the text changed 9 times.

  1. 3.1
  2. 4.0–5.0
  3. 6.0
  4. 7
  5. 8–9
  6. 10
  7. 11
  8. 12
  9. 13
  10. Arch

--help since Debian 7 (Wheezy); --kill since Debian 7 (Wheezy); --no-config since Debian 11 (Bullseye); --no-daemon since Debian 7 (Wheezy); --stderr since Debian 7 (Wheezy); --systemd since Debian 13 (Trixie); --verbose since Debian 7 (Wheezy); --version since Debian 7 (Wheezy).

--create-db until Debian 5.0 (Lenny); --no-create-db until Debian 5.0 (Lenny); --stdout until Debian 5.0 (Lenny).

Bugs

If you find a bug, please report it at <https://github.com/MusicPlayerDaemon/MPD/issues/>

Author

Max Kellermann

From mpd 0.24.18-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.