Linux

Where Is the cmus Config File?

cmus config files under ~/.config/cmus on Linux with keybinds, theme and library cache.

Last updated

cmus autowrites its settings, keybinds and theme into an autosave config under its XDG directory, with the library cache beside it. Commands typed live persist automatically, which surprises users hunting for a save button.

The library cache rebuilds from your music folder if lost. Copy the config folder and keybinds plus theme move machines together.

Where cmus stores this, by platform

Linux
~/.config/cmus/autosave

Auto-persisted settings, bindings and theme live here with the library cache nearby. Edit keybinds with :bind inside cmus rather than by hand. Copy the cmus folder with the player closed to migrate everything.

Frequently asked questions

How do I remap keys in cmus?

Use :bind inside cmus, which persists into autosave above. Hand edits work too but the running instance overwrites on exit.

Where is the cmus library cache?

Next to autosave in the folder above. Delete it to force a full library rescan from your music directory.

Notice an outdated path? Let us know.