Skip to Content
Kwybars
Installation

Build From Source

Install the build dependencies, compile Kwybars, and run it.

Kwybars is a single Rust binary. Building it needs a Rust toolchain, the PipeWire development files, and libclang (used to generate the PipeWire bindings).

Dependencies

Arch Linux:

sudo pacman -S --needed rust pipewire clang pkgconf

Debian / Ubuntu:

sudo apt install build-essential cargo libclang-dev libpipewire-0.3-dev pkg-config

Fedora:

sudo dnf install cargo gcc clang-devel pipewire-devel pkgconf-pkg-config

Kwybars needs Rust 1.88 or newer. If your distribution ships an older one, install the toolchain with rustup instead of the cargo package.

At runtime only PipeWire is needed.

Build

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

The binary is target/release/kwybars. To install it into ~/.cargo/bin:

cargo install --path .

Run

cargo run --release

Use an explicit config file when testing a custom setup:

cargo run --release -- --config ~/.config/kwybars/custom/my_config.toml

Play some audio and the visualizer appears. If it does not, cargo run --release -- doctor says what is missing.

User Service

The repository ships a user unit at assets/systemd/kwybars.service. It looks for kwybars in ~/.cargo/bin, /usr/local/bin, and /usr/bin:

install -Dm644 assets/systemd/kwybars.service ~/.config/systemd/user/kwybars.service
systemctl --user daemon-reload
systemctl --user enable --now kwybars.service

Want a ready-made look? See the preset configs.

On this page