Introduction
A light desktop audio visualizer for Wayland with layouts, themes, and automatic show and hide.
Kwybars is a desktop audio visualizer for GNU/Linux on Wayland.
It draws real-time audio bars directly on your desktop, so the visualizer feels like part of your Wayland setup instead of a terminal widget.
It is one small program. Run kwybars and it listens to what your system plays through PipeWire, shows the bars when audio starts, and hides them when it stops. While nothing is playing it does no work at all.
What You Can Do
Choose a Layout
Use line, mirror, wave, frame, radial, polygon, particle, or floating layouts depending on the look you want.
Place It Where It Fits
Put the visualizer on any screen edge, use full-length overlays, or target specific monitors.
Style It Your Way
Use built-in themes, custom colors, gradients, colors.toml, or Matugen-generated colors.
Reload While Editing
Config, colors, themes, monitor selection, and image overlays reload while Kwybars is running.
Requirements
- A Wayland compositor with the layer-shell protocol (Hyprland, Sway, niri, river, KDE Plasma, and others; GNOME does not have it)
- PipeWire
Quick Start Path
Fastest setup: install it, run kwybars, then copy one of the preset configs.
Coming from version 0.2? See Upgrading from 0.2.