cliamp ships with 20 built-in color themes and supports custom themes via simple TOML files.
Press t during playback to open the theme picker. Navigate with ↑/↓, preview live as you move, confirm with Enter, or cancel with Esc.
Your selection is saved automatically and restored on next launch.
ayu-mirage-dark, catppuccin, catppuccin-latte, dracula, ember, ethereal, everforest, flexoki-light, gruvbox, hackerman, kanagawa, matte-black, miasma, neon-blade-runner, nord, osaka-jade, ristretto, rose-pine, tokyo-night, vantablack
Create a .toml file in ~/.config/cliamp/themes/:
mkdir -p ~/.config/cliamp/themes
Each file needs all 6 colors as #RRGGBB hex values. Incomplete or malformed
custom themes are ignored, so they cannot silently make focus, warning, error,
or disabled states unreadable. The filename (minus .toml) becomes the theme name.
accent = "#268bd2"
bright_fg = "#eee8d5"
fg = "#839496"
green = "#859900"
yellow = "#b58900"
red = "#dc322f"That's it. Press t and your theme appears in the list immediately.
| Key | What it colors |
|---|---|
accent |
Title, track name, seek bar, selected items |
bright_fg |
Primary text, time display, help key pill text |
fg |
Muted/secondary text, help bar, inactive elements, help key pill background |
green |
Playing indicator, volume bar, spectrum low |
yellow |
Spectrum middle |
red |
Spectrum top, error messages |
All values are six-digit hex strings (for example, "#ff5733").
Important UI states also use stable text markers such as >, Q, ★, and !,
so selection, queued, bookmarked, and unavailable tracks remain distinguishable
in monochrome terminals.
If your custom file has the same name as a built-in theme, yours takes priority. For example, creating ~/.config/cliamp/themes/catppuccin.toml replaces the built-in catppuccin.
Add a theme line to ~/.config/cliamp/config.toml:
theme = "catppuccin"Use the filename without .toml. Leave empty or omit for terminal default colors.