Skip to main content

Themes

OpenUsage ships with 18 bundled color themes. You can cycle them live, pin one in settings, or load your own — see External themes for that.

Bundled themes​

ThemeNotes
GruvboxDefault. Retro warm contrast.
Deep SpaceCool blues over a near-black base (built-in, hardcoded; not a JSON file).
Ayu DarkWarm orange accents on slate.
Catppuccin MochaThe popular pastel-on-dark palette.
DraculaClassic vivid purple/cyan/pink.
EverforestMuted green forest tones.
GrayscalePure achromatic — useful for screenshots and accessibility tests.
KanagawaSoft Japanese woodblock palette.
Midnight IrisDeep blue-purple with iris accent.
MonokaiBright magenta and lime on dark.
Neon DuskHigh-saturation cyberpunk feel.
NightfoxCool desaturated blue/teal.
NordFrost-cool blues and greys.
One DarkAtom-inspired balanced palette.
Rose PineMuted rose and pine.
Solarized DarkThe Solarized base16 dark variant.
Synthwave 84Magenta and cyan retrowave.
Tokyo NightDeep navy with neon accents.

Switching themes​

From the dashboard​

Press t to cycle to the next theme.

The change is immediate and persisted to ~/.config/openusage/settings.json automatically.

From the settings modal​

  1. Open settings with , (or Shift+S).
  2. Switch to the Theme tab — press 3, or use Tab / Shift+Tab.
  3. Use ↑ / ↓ to highlight a theme.
  4. Press Space or Enter to apply.
  5. Press Esc to close.

From settings.json​

{
  "theme": "Tokyo Night"
}

The name match is case-sensitive and must equal the theme's name field.

Same-name precedence​

If you place an external theme with the same name as a built-in, the external version wins. This lets you tweak a built-in (say, swap the accent on Tokyo Night) without forking the source.

Color tokens​

Each theme defines 24 named color tokens that map to UI elements: base, mantle, surface0..2, overlay, text, subtext, dim, accent, blue, sapphire, green, yellow, red, peach, teal, flamingo, rosewater, lavender, sky, maroon, mauve. See External themes for the full schema and how to author your own.