Customisable gtk-layer-shell wlroots/sway bar written in rust.
Go to file
2024-02-10 21:51:35 +00:00
.github ci(build): add nix caching 2023-07-22 14:58:16 +01:00
.idea chore(intellij): update run configs 2022-09-25 22:50:05 +01:00
docs feat: enable use of markup in clock module format and format_popup, and update documentation to reflect supporting Pango markup in both 2024-02-08 23:33:32 -05:00
examples docs(examples): fix issues with example css 2024-01-24 23:10:04 +00:00
nix build(nix): add crane and naersk builders 2023-07-26 22:23:41 +01:00
scripts feat: module-level name and class options 2023-05-06 13:22:35 +01:00
src start porting to gtk4 2024-02-10 21:51:35 +00:00
.envrc feat(nix): automatic development environment with direnv 2023-08-15 20:09:32 +01:00
.gitignore chore: initial commit 2022-08-14 14:30:13 +01:00
Cargo.lock start porting to gtk4 2024-02-10 21:51:35 +00:00
Cargo.toml start porting to gtk4 2024-02-10 21:51:35 +00:00
CHANGELOG.md docs: update CHANGELOG.md for v0.14.1 [skip ci] 2024-02-10 20:53:32 +00:00
CONTRIBUTING.md docs(contributing): enforce conventional commits 2023-05-08 14:13:33 +01:00
flake.lock flake.lock: Update 2024-02-01 00:51:52 +00:00
flake.nix start porting to gtk4 2024-02-10 21:51:35 +00:00
LICENSE chore: add mit license 2022-08-14 14:32:54 +01:00
README.md docs(readme): add nixpkgs details 2023-09-16 22:59:03 +01:00
shell.nix chore(nix): add shell.nix file 2023-07-26 21:22:19 +01:00

--- Ironbar ---


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 | Configuration Guide | Style Guide


Screenshot of fully configured bar with MPD widget open

Looking for a starting point, or want to show off? Head to Show and tell


Features

  • First-class support for Sway and Hyprland
  • Fully themeable with hot-loaded CSS
  • Popups to show rich content
  • Ability to create custom widgets, run scripts and embed dynamic content
  • Easy to configure anything from a single bar across all monitors, to multiple different unique bars per monitor
  • Support for multiple config languages

Installation

Cargo

crate

Ensure you have the build dependencies installed.

cargo install ironbar

Arch Linux

aur package

yay -S ironbar-git

Nix

nix package

nix-shell -p ironbar

Flake

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

Example usage
{
  # 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.x86_64-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" "another_feature"];
          };
        }
      ];
    };
  };
}

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

Source

repo

Ensure you have the build dependencies installed.

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

  • Waybar - A lot of the initial inspiration, and a pretty great bar.
  • Rustbar - Served as a good demo for writing a basic GTK bar in Rust
  • Smithay Client Toolkit - Essential in being able to communicate to Wayland
  • gtk-layer-shell - Ironbar and many other projects would be impossible without this