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 -start

For 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 -start

Full documentation is available at tsumikii.pages.dev:

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

• 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.

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!