CMUS-REMOTE(1)

💖 CMUS-REMOTE 💖

okay bestie, welcome to the cmus-remote(1) page — that's section 1 of the General Commands Manual, and it's literally the little remote control that talks to your cmus player. no cap.

---

✨ NAME ✨

cmus-remote — control cmus 🎛️

---

🌸 SYNOPSIS 🌸

cmus-remote [OPTION]... [FILE|DIR|PLAYLIST]...
cmus-remote -C COMMAND...
cmus-remote

---

🦋 DESCRIPTION 🦋

so basically: you take a FILE, DIR or PLAYLIST and you add it to the playlist, the library (-l) or the play queue (-q). that's the vibe.

but here's the tea — if you give it no arguments at all, cmus-remote goes and reads raw commands straight from stdin, one command per line. 📥 and these raw commands? they're cmus' command mode commands — the exact same ones you use in config files and key bindings. cmus(1) has the full list if you wanna go read it, bestie. and for consistency, searching is supported too: -C /text. 🔍

and if you pass -C, then every single command line argument gets treated as a raw command. periodt.

---

💅 OPTIONS 💅

• --server SOCKET — connect through socket SOCKET instead of the default $XDG_RUNTIME_DIR/cmus-socket. 👀
• --passwd PASSWD — the password to use for a TCP/IP connection. 🔐
• --help — show usage info and dip out.
• --version — show version info and dip out.
• -p, --play — start playing. ▶️
• -u, --pause — toggle pause. ⏯️
• -U, --pause-playback — pause it, but only if it's currently playing.
• -s, --stop — stop playing. 🛑
• -n, --next — skip forward in the playlist. ⏭️
• -r, --prev — skip backward in the playlist. ⏮️
• -R, --repeat — toggle repeat. 🔁
• -S, --shuffle — toggle shuffle. 🔀
• -v, --volume VOL — change the volume. see the vol command in cmus(1). 🔊
• -k, --seek SEEK — seek. see the seek command in cmus(1). ⏩
• -f, --file FILE — play from file.
• -Q — get player status info. same as -C status. note that status is a special command that's only available to cmus-remote, iykyk. 📊
• -l, --library — modify the library instead of the playlist.
• -P, --playlist — modify the playlist (this is the default, btw).
• -q, --queue — modify the play queue instead of the playlist.
• -c, --clear — clear the playlist, the library (-l) or the play queue (-q). 🧹
• -C, --raw — treat the arguments (instead of stdin) as raw commands.

---

👑 REMOTE COMMANDS 👑

these are the special ones — only available to cmus-remote. main character energy only.

• status — print info about the track that's currently playing. 🎵
• format_print — print the arguments as Format Strings. each argument starts a new line. 📝

---

🎀 EXAMPLES 🎀

add playlists/files/directories/URLs to the library view (1 & 2):

$ cmus-remote -l music.m3u \
http://live.urn1350.net:8080/urn_high.ogg

load (clear and add) a playlist to the playlist view (3):

$ cmus-remote -c music.m3u

three different ways to toggle repeat, because we love options:

$ cmus-remote -R
$ cmus-remote -C "toggle repeat"
$ cmus-remote
toggle repeat
^D

query settings or key bindings:

$ cmus-remote -C "set repeat?"
setting: 'repeat=false'
$ cmus-remote -C "showbind common a"
bind common a win-add-l

dump the playlist to stdout:

$ cmus-remote -C "save -p -"
[...]

and yes, search works too:

$ cmus-remote -C /beatles

---

🌈 SEE ALSO 🌈

• cmus(1)

---

💜 AUTHOR 💜

written by Timo Hirvonen <tihirvon@gmail.com> 🫶

---

that's the whole page bestie, go forth and control your music 💖

okay so this was cmus version 05/11/2006 of the CMUS-REMOTE(1) page, and that's the entire manual — slay, you read all of it, I'm so proud of you 🎀✨