Colors and Matugen

colors.toml Overrides

Kwybars supports a small override file named colors.toml stored next to the active config.

Default example path:

~/.config/kwybars/colors.toml

Only two keys are overridden from this file:

• visualizer.color_rgba
• visualizer.color2_rgba

If those keys are present in colors.toml, they take precedence over the same keys in config.toml.

Example:

[visualizer]
color_rgba = "rgba(122, 162, 247, 0.95)"
color2_rgba = "rgba(187, 154, 247, 0.95)"

This is useful when you want to keep layout and runtime settings stable while swapping only the active palette.

Matugen Integration

Matugen can generate colors.toml automatically.

Create ~/.config/matugen/templates/kwybars-colors.toml:

[visualizer]
color_rgba = "{{colors.primary.default.rgba | set_alpha: 0.7}}"
color2_rgba = "{{colors.secondary.default.rgba | set_alpha: 0.7}}"

Then add the template to your Matugen config:

[templates.kwybars]
input_path = "~/.config/matugen/templates/kwybars-colors.toml"
output_path = "~/.config/kwybars/colors.toml"

Once Matugen writes the file, Kwybars can pick up the new colors through its normal reload path.