cmus-remote

Toggle play/pause

$ cmus-remote -u

$ cmus-remote -p

$ cmus-remote -U

$ cmus-remote -s

$ cmus-remote -n

$ cmus-remote -r

$ cmus-remote -k +10

$ cmus-remote -v [50]%

$ cmus-remote -q [file.mp3]

cmus-remote [options] [file|dir|playlist]

cmus-remote is a remote control interface for cmus, the ncurses-based music player. It sends commands to a running cmus instance via socket connection.
The tool allows controlling playback, managing playlists, and querying player status from scripts or other applications. It's commonly used for media key bindings and status bar integrations.

-p, --play

Start playback.

Toggle pause.

Pause without toggle.

Stop playback.

Play next track.

Play previous track.

Seek relative (+/-seconds).

Set volume (absolute or +/-).

Add file to queue.

Add file to library.

Load playlist.

Toggle setting.

Query and print status.

Send raw cmus command.

Requires running cmus instance. Socket permissions must allow connection. Some commands may not work if cmus is not playing.

cmus-remote is part of the cmus project, created by Timo Hirvonen in 2005. It provides scriptable control for the terminal-based music player, enabling integration with window managers, status bars, and multimedia keyboards.

cmus(1), mpd(1), mpc(1), playerctl(1)