Erste Schritte

Sie haben Tsumiki installiert und die Post-Installations-Schritte angewendet. Hier erfahren Sie, wie Sie schnell ein funktionierendes Panel erhalten.

1. Panel starten

Führen Sie vom Tsumiki-Projektverzeichnis aus:

./init.sh -start

Wenn Hyprland läuft, sollte die Leiste oben auf Ihrem Bildschirm erscheinen. Wenn die Leiste nicht erscheint, überprüfen Sie die Fehlerausgabe im Terminal und siehe Fehlerbehebung.

2. Autostart einrichten

Fügen Sie Tsumiki zu Ihrer Hyprland-Konfiguration hinzu, damit es beim Einloggen automatisch startet:

Öffnen Sie ~/.config/hypr/hyprland.conf und fügen Sie hinzu:

exec-once = sleep 5; ~/.config/tsumiki/init.sh -start

Die Verzögerung sleep 5 gibt Hyprland Zeit, vollständig zu initialisieren. Passen Sie den Pfad an, wenn Sie Tsumiki in ein anderes Verzeichnis geklont haben.

3. Beispielkonfiguration kopieren

Tsumiki wird mit einer vollständigen Beispielkonfiguration ausgeliefert. Kopieren Sie sie, um einen gültigen Ausgangspunkt zu erhalten:

cp example/config.toml config.toml

4. Layout anpassen

Bearbeiten Sie config.toml und passen Sie den Abschnitt [layout] an. Jeder Abschnitt (left_section, middle_section, right_section) ist ein Array von Widget-Namen:

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

Dies erzeugt eine Leiste mit:

Bereich	Widgets
Links	Arbeitsbereich-Umschalter, aktiver Fenstertitel
Mitte	Aktuelles Datum und Uhrzeit
Rechts	Lautstärkeregler, Akkustatus, System Tray, Energiemenü

5. Neu laden, um Änderungen zu übernehmen

Nach dem Speichern Ihrer Änderungen starten Sie Tsumiki neu:

pkill tsumiki
./init.sh -start

Wenn die Konfiguration gültig ist, sollte die Leiste mit Ihrem neuen Layout wieder erscheinen.

6. Allgemeine Widgets testen

Interagieren Sie mit Ihren Widgets:

Arbeitsbereiche — Klicken zum Wechseln, scrollen zum Durchlaufen der Desktops.
Lautstärke — Klicken zum Stummschalten, scrollen zum Anpassen.
Akku — Darüberfahren, um Restzeit und Ladestatus zu sehen.
Datum/Uhrzeit — Klicken, um Kalender und Benachrichtigungsfeld zu öffnen.
System Tray — Vorhandene Tray-Symbole sollten automatisch erscheinen.

7. Machen Sie es zu Ihrem

Farben ändern — Siehe Themes erstellen für SCSS-Anpassung oder Matugen für automatische Hintergrundbild-basierte Theming.
Weitere Widgets hinzufügen — Durchsuchen Sie die Widgets-Referenz für alle über 45 verfügbaren Widgets.
Module aktivieren — Probieren Sie das Dock, den Launcher oder das OSD aus.
Verhalten konfigurieren — Siehe die vollständige Konfigurations-Referenz für jede Option.

Fehlerbehebung

Wenn etwas nicht stimmt:

Leiste erscheint nicht — Überprüfen Sie, ob Hyprland läuft und keine anderen Leisten aktiv sind (pkill waybar).
Keine Symbole — Stellen Sie sicher, dass JetBrains Nerd Font installiert und als Terminal-/UI-Schriftart konfiguriert ist.
Fehlende Funktionalität — Einige Widgets erfordern externe Tools (z.B. playerctl für Medien, brightnessctl für Helligkeit). Führen Sie ./init.sh -setup aus, um sicherzustellen, dass alle Abhängigkeiten installiert sind.
SASS-Fehler — Ihre config.toml könnte ungültig sein. Vergleichen Sie sie mit example/config.toml.

Weitere Hilfe finden Sie auf den Seiten FAQ oder Fehlerbehebung.