Tsumiki

A modular status bar for Hyprland, built on Fabric.

Quick Start · Documentation · Contributing · License

No, this isn't Waybar. Yes, it's written in Python. Yes, it's still fast. 🐍

Tsumiki (積み木 — Japanese for "building blocks") is a modular status bar for the Hyprland Wayland compositor. Built on Fabric, it offers a flexible, widget-based architecture for creating custom desktop panels — lightweight, performant, and deeply configurable.

---

Screenshots

Features

• Hyprland-native — Full integration with Hyprland's ecosystem and event model.
• Modular widget system — 45+ widgets: workspaces, system tray, media, battery, CPU, weather, dock, launcher, and more.
• Fully themeable — Customize every element with SCSS; generate dynamic Material You color schemes from your wallpaper.
• Highly configurable — TOML-based configuration with hot-reload. Control layout, behavior, and appearance of every widget.
• Notification system — Built-in notification daemon with Do Not Disturb, grouping, and history persistence.
• On-screen displays — OSD overlays for volume, brightness, microphone, and lock keys.
• Lightweight & fast — Designed for minimal memory and CPU overhead.

Documentation

Full documentation is available at tsumikii.pages.dev:

Section	Description
Getting Started	Overview, installation, first steps
Configuration	Layout, widget options, modules
Widgets Reference	Complete widget configuration reference
Modules Reference	Bar, dock, notifications, launcher, OSD
Theming	SCSS customization, Matugen, tips
FAQ & Troubleshooting	Common issues and solutions
Post-Installation	Hyprland layer rules for effects

Support the Project

Contributing

We welcome contributions of all sizes. Please see the contributing guidelines before opening a pull request.

Acknowledgements

• Waybar — Initial inspiration.
• Hyprpanel — Design and feature inspiration.

Special thanks to darsh (creator of Fabric), gummy bear album, axenide, sankalp for code contributions, bug fixes, and design ideas.

Contributors

Thanks to all contributors (emoji key):

Robin Seger 💻 🎨	Adriano Tisera 💻 🐛	Anshul J. 💻 🐛	Sankalp Tharu 💻 🐛	Keepo 💻	Sayeed Mahmood Evrenos 🐛	xeyossr 📖
DIMFLIX 🐛	Janne Hakonen 💻 🐛	Fabien Devaux 🐛	Tiz 💻 🐛 📖	Alaa Elsamouly 📖	Muhammad Ahmad Chaudhary 🐛

This project follows the all-contributors specification. Contributions of any kind welcome!

License

Distributed under the GPL-3.0 License.

⭐ Star the repo if you find it useful!