JakeStanger/ironbar
1
1
Fork 0
mirror of https://github.com/JakeStanger/ironbar.git synced 2024-11-29 21:16:00 +03:00
Code Issues Packages Projects Releases Wiki Activity
Customisable gtk-layer-shell wlroots/sway bar written in rust.
74 Commits 6 Branches 22 Tags 10 MiB
Rust 97.6%
Nix 1.9%
Shell 0.5%
f411b7c451
Go to file
Jake Stanger f411b7c451
chore: update lockfile
2022-10-14 23:53:13 +01:00
.github/workflows ci: alter changelog categories 2022-09-25 22:50:17 +01:00
.idea chore(intellij): update run configs 2022-09-25 22:50:05 +01:00
examples docs: update json example 2022-09-25 22:49:54 +01:00
src feat(launcher): add popup css selectors 2022-10-14 23:49:11 +01:00
.gitignore chore: initial commit 2022-08-14 14:30:13 +01:00
Cargo.lock chore: update lockfile 2022-10-14 23:53:13 +01:00
Cargo.toml feat: wlroots-agnostic support for focused module 2022-10-04 23:26:07 +01:00
CHANGELOG.md docs: update CHANGELOG.md for v0.5.2 [skip ci] 2022-09-07 21:49:04 +00:00
CONTRIBUTING.md docs: add contributing guidelines file 2022-08-14 14:34:27 +01:00
LICENSE chore: add mit license 2022-08-14 14:32:54 +01:00
README.md docs(readme): update references to sway 2022-10-14 22:14:04 +01:00

README.md

Ironbar

Ironbar is a customisable and feature-rich bar targeting wlroots compositors, written in Rust. It uses GTK3 and gtk-layer-shell.

The bar can be styled to your liking using CSS and hot-loads style changes. For information and examples on styling please see the wiki.

Screenshot of fully configured bar with MPD widget open

Installation

Run using ironbar.

Cargo

cargo install ironbar

crate

Arch Linux

yay -S ironbar-git

aur package

Source

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

repo

Configuration

Ironbar gives a lot of flexibility when configuring, including multiple file formats and options for scaling complexity: you can use a single config across all monitors, or configure different/multiple bars per monitor.

A full configuration guide can be found here.

Styling

To get started, create a stylesheet at .config/ironbar/style.css. Changes will be hot-reloaded every time you save the file.

A full styling guide can be found here.

Project Status

This project is in alpha, but should be usable. Everything that is implemented works and should be documented. Proper error handling is in place so things should either fail gracefully with detail, or not fail at all.

There is currently room for lots more modules, and lots more configuration options for the existing modules. The current configuration schema is not set in stone and breaking changes could come along at any point; until the project matures I am more interested in ease of use than backwards compatibility.

A few bugs do exist, and I am sure there are plenty more to be found.

The project will be actively developed as I am using it on my daily driver. Bugs will be fixed, features will be added, code will be refactored.

Contribution Guidelines

Please check here.

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