NixOS

Kwybars exposes a flake package, runnable flake apps, and a NixOS module.

NixOS Module

Add it as a flake input:

{
  inputs.kwybars.url = "github:naurissteins/Kwybars";
}

Then import the module and enable it in your NixOS configuration:

{ inputs, ... }:
{
  imports = [
    inputs.kwybars.nixosModules.default
  ];

  programs.kwybars.enable = true;
}

This installs kwybars-daemon, kwybars-overlay, kwybarsctl, bundled themes, the example config, and the packaged user service.

If you also want the module to provide and enable the user daemon service:

{
  programs.kwybars = {
    enable = true;
    systemd.enable = true;
  };
}

Package or App

Build and run from GitHub:

nix build github:naurissteins/Kwybars
./result/bin/kwybars-daemon

Run directly without installing:

nix run github:naurissteins/Kwybars
nix run github:naurissteins/Kwybars#kwybars-overlay
nix run github:naurissteins/Kwybars#kwybarsctl

From a local checkout:

nix build
./result/bin/kwybars-daemon

First Launch

Once kwybars-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.