Skip to Content
Kwybars
Installation

Debian / Ubuntu

Install Kwybars from the prebuilt Debian package on Debian and Ubuntu based systems

Download the latest kwybars_<version>-1_amd64.deb file from the GitHub releases:

wget -O /tmp/kwybars_0.3.0-1_amd64.deb https://github.com/naurissteins/Kwybars/releases/download/0.3.0/kwybars_0.3.0-1_amd64.deb

Install it with apt:

sudo apt install /tmp/kwybars_0.3.0-1_amd64.deb

The only runtime dependency is PipeWire.

First Launch

Run it from a terminal:

kwybars

Play some audio and the visualizer appears. It hides again when the audio stops.

If nothing shows up, run kwybars doctor. It checks your config, the compositor, your monitors, and PipeWire, and says what is missing.

Start With Your Session

Pick one of the two.

Start it from your compositor config. For Hyprland:

# if you use UWSM
exec-once = uwsm app -- kwybars

# otherwise
exec-once = kwybars

For Sway, use exec kwybars. For niri, use spawn-at-startup "kwybars".

Or enable the user service:

systemctl --user enable --now kwybars.service

The service is tied to graphical-session.target, so it suits sessions that systemd manages (UWSM, niri's session, GNOME, KDE). If your compositor does not start that target, use the compositor config instead.

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

On this page