tldr/pages/linux/cmus.md

# cmus

> Command-line Music Player.
> Use `<ArrowKeys>` to navigate, `<Enter>` to select, and numbers `<1>`-`<8>` switch between different views.
> See also: `ncmpcpp`, `clementine`, `qmmp`.
> More information: <https://manned.org/cmus>.

- Open `cmus` into the specified directory (this will become your new working directory):

`cmus {{path/to/directory}}`

- Add file/directory to library:

`<:>add {{path/to/file_or_directory}}`

- Refresh the metadata of songs in the library:

`<:>update-cache`

- Search for songs, albums, or artists:

`</>{{something}}`

- Pause/unpause current song:

`<c>`

- Toggle shuffle mode on/off:

`<s>`

- Quit `cmus`:

`<q>`