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.
 |
|||
 |
|||
 |
 |
 |
 |
- 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.
Prerequisites: Hyprland, JetBrains Nerd Font, Python 3.12+.
# Clone the repository
git clone https://github.com/rubiin/tsumiki.git ~/.config/tsumiki
cd ~/.config/tsumiki
# Automated setup (installs dependencies)
./init.sh -setup
# Start Tsumiki
./init.sh -startFor one-line bootstrap, detailed installation options, and manual dependency guides, see the Installation guide.
Add to your Hyprland config to autostart:
exec = sleep 5; ~/.config/tsumiki/init.sh -startFull 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 |
We welcome contributions of all sizes. Please see the contributing guidelines before opening a pull request.
Special thanks to darsh (creator of Fabric), gummy bear album, axenide, sankalp for code contributions, bug fixes, and design ideas.
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!
Distributed under the GPL-3.0 License.
⭐ Star the repo if you find it useful!