Configuration

Logging

Where logs are written and how to adjust log output.

Both kwybars-overlay and kwybars-daemon log to stderr and to a file.

Default Log Files

~/.local/state/kwybars/overlay.log
~/.local/state/kwybars/daemon.log

If XDG_STATE_HOME is set, logs are written under:

$XDG_STATE_HOME/kwybars/

Adjust Log Level

Use KWYBARS_LOG or RUST_LOG to control the log level or filter:

KWYBARS_LOG=debug kwybars-daemon

Override Log File Path

Use KWYBARS_LOG_FILE if you want to write logs to a different file:

KWYBARS_LOG_FILE=/tmp/kwybars-daemon.log kwybars-daemon

Notes

timestamps use local time
startup logs should show whether a real config file was found or defaults were used
file logging is useful when started through compositor autostart or a user service

Config Switching

Use a stable active config path with kwybarsctl switch-config.

Colors and Matugen

Override colors with colors.toml or generate them from Matugen.

On this page

Default Log Files Adjust Log Level Override Log File Path Notes