Skip to Content
Kwybars
Installation

NixOS

Install with the NixOS module, flake package, or flake app.

Kwybars exposes a flake package, a runnable flake app, 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, the example configs, the theme files, the man page, and the user service file.

If you also want the module to enable the user service:

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

The module can also choose the config. Use at most one of these:

OptionWhat it does
programs.kwybars.settingsConfig written as a Nix attribute set
programs.kwybars.configPathPath to a TOML file you manage yourself, for example ~/.config/kwybars/current.toml
programs.kwybars.presetName of a bundled example, for example "wave"

Package or App

Build and run from GitHub:

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

Run directly without installing:

nix run github:naurissteins/Kwybars

From a local checkout:

nix build
./result/bin/kwybars

First Launch

Once kwybars is running, play some audio and the visualizer appears. Without the service, start it from your compositor config, for example exec-once = kwybars for Hyprland.

If nothing shows up, run kwybars doctor.

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

On this page