--- Ironbar ---

Current version Build status Open issues License Crates.io downloads
A customisable and feature-rich GTK bar for wlroots compositors, written in Rust. Ironbar is designed to support anything from a lightweight bar to a full desktop panel with ease. --- ## Getting Started [Wiki](https://github.com/JakeStanger/ironbar/wiki) | [Configuration Guide](https://github.com/JakeStanger/ironbar/wiki/configuration-guide) | [Style Guide](https://github.com/JakeStanger/ironbar/wiki/styling-guide) --- ![Screenshot of fully configured bar with MPD widget open](https://f.jstanger.dev/github/ironbar/bar.png?raw) ✨ Looking for a starting point, or want to show off? Head to [Show and tell](https://github.com/JakeStanger/ironbar/discussions/categories/show-and-tell) ✨

Features

Installation

Cargo

crate

Ensure you have the build dependencies installed.

sh cargo install ironbar

Arch Linux

aur package

sh yay -S ironbar-git

Nix Flake

A flake is included with the repo which can be used with Home Manager.

Example usage

```nix { # Add the ironbar flake input inputs.nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable"; inputs.ironbar = { url = "github:JakeStanger/ironbar"; inputs.nixpkgs.follows = "nixpkgs"; }; inputs.hm = { url = "github:nix-community/home-manager"; inputs.nixpkgs.follows = "nixpkgs"; };

outputs = inputs: { homeManagerConfigurations."USER@HOSTNAME" = inputs.hm.lib.homeManagerConfiguration { pkgs = nixpkgs.legacyPackages.x8664-linux; modules = [ # And add the home-manager module inputs.ironbar.homeManagerModules.default { # And configure programs.ironbar = { enable = true; config = {}; style = ""; package = inputs.ironbar; features = ["feature" "anotherfeature"]; }; } ]; }; }; } ```

There is a Cachix cache available at https://app.cachix.org/cache/jakestanger.

Source

repo

Ensure you have the build dependencies installed.

```sh git clone https://github.com/jakestanger/ironbar.git cd ironbar cargo build --release

change path to wherever you want to install

install target/release/ironbar ~/.local/bin/ironbar ```

By default, all features are enabled. See here for controlling which features are included.

Running

Once installed, you will need to create a config and optionally a stylesheet in .config/ironbar. See the Configuration Guide and Style Guide for full details.

Ironbar can be launched using the ironbar binary.

Log verbosity can be changed using IRONBAR_LOG or IRONBAR_FILE_LOG. You can use any of error, warn, info, debug or trace.

These default to IRONBAR_LOG=info and IRONBAR_FILE_LOG=error.

File output can be found at ~/.local/share/ironbar/error.log.

Status

Ironbar is an alpha project. It is unfinished and subject to constant breaking changes, and will continue that way until the foundation is rock solid.

If you would like to take the risk and help shape development, any bug reports, feature requests and discussion is welcome.

I use Ironbar on my daily driver, so development is active. Features aim to be stable and well documented before being merged.

Contribution Guidelines

All are welcome, but I ask a few basic things to help make things easier. Please check here for details.

Acknowledgements