cmus
small, fast console music player
TLDR
Open cmus in a specific directory
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 playbacks
Toggle shuffler
Toggle repeatb
Next trackz
Previous track1-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)
