rmpc

rmpc [options] [command]

rmpc is a Rust TUI client for mpd. It shows the queue, library, lyrics, and album art, and also works as a scripting CLI so you do not need mpc for play/pause/next. Commands available on the CLI are the same as TUI command mode (`:`).Default config can be printed with rmpc config and used as a starting point.

-a, --address host:port

MPD address (overrides config).

MPD password.

Config file path.

Theme file path.

MPD partition to use.

Create the partition if it does not exist (requires --partition).

With no command, rmpc opens the TUI. Headless commands include play, pause, unpause, togglepause, stop, next, prev, volume, repeat, random, single, consume and their toggle* variants, seek, clear, add, status, song, update, rescan, albumart, config, theme, outputs, sticker, and remote.remote talks to a running TUI instance (`keybind`, `switchtab`, `status`, `query`). Pass --pid to target one process.

Requires a running MPD instance. Album art and some extras depend on optional runtime libraries; rmpc debuginfo lists them. albumart exit codes: 0 success, 1 error, 2 no art, 3 nothing playing.

Written by mierak as a modern MPD client with sixel/kitty image support.

mpd(1), mpc(1), ncmpcpp(1)

Source code · Documentation · Homepage