Skip to Content
Kwybars
Installation

Arch Linux

Install from the AUR with either the prebuilt package or the latest git build.

PackageDescription
kwybars-binPrebuilt package, recommended for most users
kwybars-gitBuilds the latest Git branch from source

Install from the AUR with your helper of choice:

# pre-compiled binary (recommended)
yay -S kwybars-bin

# or build from source via AUR
yay -S kwybars-git

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