Skip to Content
Kwybars
Configuration

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.85

theme_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:

  1. themes/ next to the config file
  2. themes/ next to the file the config links to, if the config path is a link
  3. ~/.config/kwybars/themes/
  4. directories listed in KWYBARS_THEMES_DIR
  5. /usr/share/kwybars/themes/
  6. 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-dark
  • catppuccin-mocha
  • dracula
  • everforest
  • gruvbox
  • nord
  • rose-pine
  • tokyo-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.
  • name is optional, only a label shown in kwybars validate-config and the log.
  • Put [theme] after top-level keys such as theme_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.

On this page