User Tools

Site Tools


terminal:cmus

This is an old revision of the document!


cmus

cmus is a terminal music player. The keybinds and actions are very vim-like.

Install

# Install cmus in Debian
sudo apt install cmus

Getting help

There is a man page with lots of information.

# Read cmus documentation
man cmus

Or, when inside the app, press 7 to view the help tab. 1-6 are the other tabs.

7

Add music to library

# Add music from disk
:add ~/Music

Alternatively, press 5 to view the file browser. Find the file or directory you want to add, and press a to add it.

Save settings

If you ever want to save settings, run :save. This will happen when existing automatically.

:save

Clear library

# Remove all music from list
:clear

Browse library

Press 1 or 2 to browse the library. View 1 is the sorted tree view. View 2 is the flat list of all songs.

To search, type / and enter the phrase. Press n to find next occurrence and SHIFT-n to go backwards.

Play

You can press x to start the player, or use the commands like :player-play. Remember there is auto-complete, and hotkey 7 available if you need help.

# To play, press `x`, or run commands:
:player-play
:player-pause
:player-stop

If you find a song you want to play in the browser, just press ENTER on the song to play it.

Queue a song

Press e to queue a song. It will get played next even if shuffle is on. It will get popped off the queue once it starts.

Press 4 to view the queue.

Playlists

Press 3 to view the tab with playlists.

Create a playlist with :pl-create My Favorites. Playlists are stored in .config/cmus/playlists.

Navigate to a playlist and press space to select it. An asterisk will appear next to it, designating it the active playlist.

Shuffle, Repeat, Continue

In the bottom right, there are four flags: CRFS. They stand for:

  • Continue - SHIFT-c to toggle. Continues to next song after finishing
  • Repeat - r to toggle. Repeats playlist when complete
  • Shuffle - s to toggle. Randomizes next song
  • Follow - f to toggle. Jump your cursor to the next song when it plays, versus leaving you where you are.
terminal/cmus.1647297471.txt.gz · Last modified: 2022/03/14 22:37 by nanodano