capybar

Crates.iocapybar
lib.rscapybar
version0.3.0
created_at2025-07-14 10:59:46.850687+00
updated_at2025-08-04 18:02:28.796922+00
descriptionWayland native toolbar
homepage
repositoryhttps://github.com/CapyCore/capybar
max_upload_size
id1751522
size204,309
Plotnikov Daniil (Pepengu)

documentation

README

Capybar

[!CAUTION] Bar is in very early stages of development. Everything might change and nothing might work for you

Right now only hyprland was tested. Other compositors could work wrong, althogh most likely won't

Simple customizable bar applications that aims to have as little external dependencies (like gtk, qt, upowerd etc.) as possible.

Features

  • Custom widgets creation via rust
  • Pre-built widgets:
    • Text
    • IconText
    • Clock
    • Battery
    • CPU usage
    • Keyboard layout
    • Row container (WIP)
    • Bar container

Instalation

Nix

Capybar can be installed on nix using home manager.

  • Extend your inputs with:
 inputs = {
    # ...
    capybar.url = "github:CapyCore/capybar"; 
  };
  • Extend your imports with:
imports = [ inputs.capybar.homeManagerModules.default ];
  • Enable capybar:
programs.capybar = {
    enable = true;
}

Others

Capybar can be installed via cargo using

cargo install capybar

This will install and setup capybar executable.

Building from source

Bulding the bar is done with cargo. The example is located in examples folder.

cargo build --release

After building the bar the executable will be located in ./target/release/

Usage

Capybar can be run using capybar command in a terminal of your choice. You can change configuration path via flag --cfg_path (default path is $HOME/.config/capybar) and config extention via --cfg_type (default is toml, no other types are currently supported). More info could be accesed wit --help flag.

License

Capybar is licensed under the MIT license. See LICENSE for more information.

Acknowledgements

Commit count: 0

cargo fmt