Themes
Built-in themes, custom themes in the config or in theme files, and theme lookup order.
Kwybars comes with built-in themes and reads your own theme files.
Select the active theme in config.toml:
theme = "catppuccin-mocha"
theme_opacity = 0.85theme_opacity multiplies the alpha of all bars generated from the theme palette.
Theme Lookup Order
For theme = "name", Kwybars looks for name.toml in this order and uses the first one it finds:
themes/next to the config filethemes/next to the file the config links to, if the config path is a link~/.config/kwybars/themes/- directories listed in
KWYBARS_THEMES_DIR /usr/share/kwybars/themes/- the themes built into Kwybars
That means your own theme file can replace a built-in theme with the same name.
kwybars list-themes shows every theme you can use and where it comes from.
Built-In Themes
ayu-darkcatppuccin-mochadraculaeverforestgruvboxnordrose-pinetokyo-night
Custom Themes
The quickest way is to write the colors straight into config.toml:
[theme]
red = "#ea6c73"
green = "#7fd962"
yellow = "#f9af4f"
blue = "#53bdfa"
magenta = "#cda1fa"
cyan = "#90e1c6"- All six colors are required.
- The table turns the theme on by itself. Do not also add
theme = "...", which looks for a theme file instead. nameis optional, only a label shown inkwybars validate-configand the log.- Put
[theme]after top-level keys such astheme_opacity; everything below a[section]header belongs to that section. [visualizer.theme]works the same way.
Theme Files
To share a theme between configs, or to have a tool such as Matugen or Wallust write it, 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"The file uses the same keys as [theme], so you can move a palette between the two by copying it.
Rendering Behavior
Bars take the six theme colors in turn. With gradient_direction = "horizontal" the colors blend smoothly across the layout instead. If the theme cannot be found or read, Kwybars uses color_rgba and color2_rgba and says so in the log.
Theme files are hot reloaded. A theme file you create while Kwybars is running is picked up as soon as it exists.