Übersicht

Was ist Tsumiki?

Tsumiki (ehemals Hydepanel) ist eine modulare Statusleiste für den Hyprland Wayland-Compositor. Es basiert auf dem Fabric Widget-System und bietet eine flexible Architektur für den Bau benutzerdefinierter Desktop-Panels durch zusammensetzbare Widgets.

Der Name Tsumiki (積み木) ist Japanisch für “Bausteine” — was das modulare, stapelbare Design des Projekts widerspiegelt.

Voraussetzungen

Stelle vor der Installation von Tsumiki sicher, dass dein System diese Anforderungen erfüllt:

Anforderung	Hinweise
Hyprland	Eine funktionierende Hyprland-Installation ist erforderlich
JetBrains Nerd Font	Für die Darstellung von Symbolen und Glyphen erforderlich
Python 3.12+	Tsumiki benötigt Python 3.12
Arch Linux (empfohlen)	Für Arch optimierte Pakete; andere Distributionen benötigen ggf. manuelle Einrichtung
NetworkManager	Für Netzwerk-Widgets und -Dienste erforderlich
PipeWire	Für Audio-Widgets und OSD erforderlich

Schlüsselkonzepte

Widgets

Widgets sind die einzelnen Bausteine, die in der Leiste erscheinen. Es gibt über 45 integrierte Widgets für:

• Systeminfo — CPU, RAM, GPU, Speicher, Netzwerkauslastung
• Hardware-Steuerung — Lautstärke, Helligkeit, Mikrofon, Akku
• Desktop-Verwaltung — Arbeitsbereiche, Fenstertitel, Taskleiste
• Dienstprogramme — Screenshot, OCR, Zwischenablage, Bildschirmaufnahme
• Produktivität — Pomodoro-Timer, Kanban-Board, Stoppuhr, Emoji-Auswahl
• Integration — Wetter, Mediensteuerung, Git-Companion, DNS-Umschalter

Jedes Widget wird unter [widgets.<name>] in config.toml konfiguriert. Siehe die Widgets-Referenz für die vollständige Liste.

Module

Module sind größere UI-Oberflächen, die über die Leiste hinausgehen — eigenständige Fenster oder Overlays:

• Leiste — Das Hauptpanel selbst
• Benachrichtigungssystem — Desktop-Benachrichtigungsanzeige
• Dock — Anwendungs-Dock mit Intellihide
• Übersicht — Vollbild-Arbeitsbereichs-Exposé
• Launcher — Tastaturgesteuerte Anwendungssuche
• OSD — Bildschirmanzeigen für Lautstärke, Helligkeit usw.
• Desktop-Uhr — Dekorative Uhren-Überlagerung
• Desktop-Zitate — Inspirierende Zitate-Anzeige

Module werden unter [modules.<name>] in config.toml konfiguriert. Siehe die Module-Referenz für Details.

Layout

Die Widget-Platzierung in der Leiste wird durch den Abschnitt [layout] in config.toml gesteuert:

[layout]
left_section = ["workspaces", "window_title"]
middle_section = ["date_time"]
right_section = ["volume", "battery", "system_tray"]

Widgets können auch gruppiert oder in einklappbaren Gruppen platziert werden. Siehe Konfiguration für Details.

Dienste

Dienste sind Hintergrundprozesse, die Daten an Widgets liefern — sie überwachen Akkustand, Netzwerkstatus, Mediaplayer, Wetter und mehr. Widgets verbinden sich über GTK-Signale mit Diensten, was Aktualisierungen effizient hält.

Architektur

Die Architektur von Tsumiki folgt einem geschichteten Design:

┌──────────────────────────────────────────────┐
│                  main.py                       │
│   ┌──────────┐  ┌──────────┐  ┌───────────┐  │
│   │ Config    │  │ CSS      │  │ Module     │  │
│   │ Loader   │  │ Compiler │  │ Init       │  │
│   └──────────┘  └──────────┘  └───────────┘  │
└─────────────────────┬────────────────────────┘
                      │
        ┌─────────────┼─────────────┐
        ▼             ▼             ▼
  ┌──────────┐  ┌──────────┐  ┌──────────┐
  │ Services │  │ Widgets  │  │ Modules  │
  │ (DBus,   │──▶│ (Panel   │──▶│ (Overlay │
  │ polling) │  │ buttons) │  │ windows) │
  └──────────┘  └──────────┘  └──────────┘

• Dienste laufen im Hintergrund und senden GTK-Signale bei Zustandsänderungen
• Widgets sind Panel-Buttons, die Dienstsignale abonnieren
• Module sind eigenständige GTK-Fenster für Overlays und Popups

Siehe die Seite Architektur für einen tieferen Einblick.

Empfohlener Weg

1. Tsumiki installieren — Klonen, Abhängigkeiten installieren, Umgebung einrichten.
2. Erste Schritte — Leiste starten, Layout konfigurieren, Post-Installationsregeln anwenden.
3. Konfiguration — Die TOML-Konfigurationsstruktur und verfügbare Optionen verstehen.
4. Theme wählen — Mit einem integrierten Theme starten oder ein eigenes erstellen mit Themes erstellen.
5. Erkunden — Widgets hinzufügen, Module aktivieren, Verhalten anpassen.

Hilfe benötigt?

• Prüfe die FAQ für häufige Probleme.
• Besuche Fehlerbehebung für Debugging-Hilfe.
• Tritt dem Discord bei für Community-Support.