mpc

mpc [options] [command] [arguments]

mpc is a command-line client for MPD (Music Player Daemon). It connects to a running MPD instance and controls playback, playlists, volume, and playback state according to commands and arguments passed to it.If no command is given, the current status is printed (same as mpc status).

-f, --format FORMAT

Configure song display format using metadata delimiters like %artist%, %album%, %title%, %track%, %time%, %file%.

Host to connect to. Use password@host for authentication. An absolute path connects via Unix Domain Socket.

Port to connect to (default: MPD_PORT env or 6600).

Suppress current song status after commands.

Verbose output.

Wait for operation to finish (e.g., database update).

play [position]

Start playback, optionally at a playlist position.

Pause playback.

Toggle play/pause.

Stop playback.

Skip to next track.

Go to previous track.

Seek within current song (e.g., +10, -5, 50%).

Set volume percentage (0-100), or relative (+5, -5).

Toggle or set repeat mode.

Toggle or set random mode.

Shuffle the current playlist.

Get or set crossfade between songs (0 disables).

Add a song to the playlist.

Clear the playlist.

Print the current playlist.

Search for songs in the database.

Scan for updated files in the music directory.

Display current playback status.

Requires a running MPD instance. The client does not play audio itself. Connection parameters default to localhost:6600 or can be set via MPDHOST and MPDPORT environment variables.

mpc was created as the reference command-line client for the Music Player Daemon project.

mpd(1), ncmpcpp(1), mpv(1)