Themes

Kwybars supports packaged themes and user themes without adding a separate theme engine.

Select the active theme in config.toml:

theme = "catppuccin-mocha"
theme_opacity = 0.85

theme_opacity multiplies the alpha of all bars generated from the theme palette.

Theme Lookup Order

For theme.toml, Kwybars resolves themes in this order:

1. ~/.config/kwybars/themes/theme.toml
2. /usr/share/kwybars/themes/theme.toml
3. repo/assets/themes/theme.toml

That means your own theme file can override a packaged theme with the same name.

Built-In Themes

• ayu-dark
• catppuccin-mocha
• dracula
• everforest
• gruvbox
• nord
• rose-pine
• tokyo-night

Custom Themes

Create a theme file under:

~/.config/kwybars/themes/

Example:

name = "your-theme"

red = "#ea6c73"
green = "#7fd962"
yellow = "#f9af4f"
blue = "#53bdfa"
magenta = "#cda1fa"
cyan = "#90e1c6"

Then enable it:

theme = "your-theme"

Rendering Behavior

Theme palettes are six-color sequences:

• red
• green
• yellow
• blue
• magenta
• cyan

Bars are distributed across the palette by index by default. If you set gradient_direction = "horizontal", line, mirror, and frame layouts use a smooth multi-stop gradient across the full layout instead, while radial and polygon layouts interpolate smoothly between theme stops around bar order. If theme loading fails, Kwybars falls back to color_rgba and color2_rgba from the active config.