Build From Source

Install dependencies on Arch Linux:

sudo pacman -S --needed rust gdk-pixbuf2 gtk4 gtk4-layer-shell pipewire cava

Optional desktop notifications use libnotify:

sudo pacman -S --needed libnotify

Build

git clone https://github.com/naurissteins/Kwybars.git
cd Kwybars
cargo build --workspace

Run

Run the daemon:

cargo run -p kwybars-daemon

Or run the overlay directly:

cargo run -p kwybars-overlay

Use an explicit config file when testing a custom setup:

cargo run -p kwybars-daemon -- --config ~/.config/kwybars/custom/my_config.toml

Once the daemon is running, play some audio and the visualizer should appear automatically.

If you want a ready-made look before reading the full configuration reference, start with the preset configs.