mpc(1)
Control the Music Player Daemon (mpd) from the command line.
Synopsis
mpc [OPTION]... [COMMAND] [ARG]...Description
mpc is a lightweight command-line client for Music Player Daemon (mpd). It allows you to control playback, manage the playlist, and query the status of mpd without needing a graphical interface.
You can play, pause, skip tracks, adjust volume, add songs to the queue, and view the current playlist. mpc is ideal for scripts, remote access over SSH, and minimal desktop environments.
Common options
| Flag | What it does |
|---|---|
-h, --host | Connect to a specific mpd host (default: localhost) |
-p, --port | Connect to a specific mpd port (default: 6600) |
-P, --password | Use the specified password to authenticate with mpd |
-q, --quiet | Suppress status output and confirmation messages |
-f, --format | Format output using a custom format string |
-w, --wait | Wait for a status change before exiting (useful for monitoring) |
--no-status | Do not print mpd status after executing a command |
Examples
Display current playback status, current song, and volume
mpcPlay if paused, pause if playing
mpc toggleSkip to the next track in the playlist
mpc nextSet volume to 80%
mpc volume 80Add a song to the current playlist
mpc add /path/to/song.mp3Display the entire current playlist
mpc playlistJump to 1 minute 30 seconds in the current track
mpc seek 1:30Start playing on a remote mpd server at that IP address
mpc -h 192.168.1.100 play