LinuxCommandLibrary

cmus

small, fast console music player

TLDR

Open cmus in a specific directory

$ cmus [path/to/directory]
copy
Add file or directory to library
$ :add [path/to/file_or_directory]
copy
Refresh the metadata of songs in library
$ :update-cache
copy
Search for songs, albums, or artists
$ /[something]
copy
Pause/unpause current song
$ c
copy
Toggle shuffle mode
$ s
copy
Quit cmus
$ q
copy

SYNOPSIS

cmus [options] [directory]

DESCRIPTION

cmus is a small, fast, and powerful console music player for Unix-like systems. It supports a wide range of audio formats including Ogg Vorbis, MP3, FLAC, Opus, Musepack, WavPack, WAV, AAC, and MP4 through its plugin-based codec system.
The interface provides multiple views accessed via number keys 1-7: library (artist/album tree), sorted library (flat list), playlist, play queue, directory browser, filters, and settings. Navigation uses arrow keys and Enter to select, with vi-style keybindings available throughout.
cmus features gapless playback, ReplayGain support, and can be controlled remotely via the cmus-remote command or its socket interface, making it suitable for integration with window managers and status bars.

CONFIGURATION

~/.config/cmus/autosave

Automatically saved settings, library state, and playback position on exit.
~/.config/cmus/rc
Startup commands executed when cmus launches (keybindings, settings, colors).

KEYBINDINGS

c

Pause/unpause playback
s
Toggle shuffle
r
Toggle repeat
b
Next track
z
Previous track
1-8
Switch views (library, sorted, playlist, queue, browser, filters, settings)
q
Quit
:add path
Add files to library
/query
Search

CAVEATS

Terminal-based, requires a capable terminal emulator. Audio output depends on available backends (ALSA, PulseAudio, etc.). Some formats may require additional codec libraries.

SEE ALSO

cmus-remote(1), ncmpcpp(1), mpd(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community