Installation

Voraussetzungen

Stellen Sie sicher, dass diese Komponenten installiert sind, bevor Sie fortfahren:

Voraussetzung	Installationsbefehl (Arch Linux)	Hinweise
Hyprland	`sudo pacman -S hyprland`	Laufende Hyprland-Instanz erforderlich
JetBrains Nerd Font	`sudo pacman -S ttf-jetbrains-mono-nerd`	Für die Symbolanzeige erforderlich
Python 3.12+	`sudo pacman -S python`	Überprüfen: `python --version`
Git	`sudo pacman -S git`	Für das Klonen erforderlich
NetworkManager	`sudo pacman -S networkmanager`	Von Netzwerk-Widgets benötigt
PipeWire	`sudo pacman -S pipewire pipewire-pulse`	Von Audio-Widgets benötigt

Klonen

git clone https://github.com/rubiin/tsumiki.git ~/.config/tsumiki
cd ~/.config/tsumiki

Neueste Version

Version:v4.0.2Datum:2026-08-07

Vollständige Versionshinweise und Assets finden Sie auf der Release-Seite auf GitHub.

Installationsoptionen

Wählen Sie eine der folgenden drei Methoden.

Option 1: Bootstrap-Skript (Schnellste)

curl -fsSL https://raw.githubusercontent.com/rubiin/tsumiki/master/install.sh | bash

Dieses Skript klont oder aktualisiert ~/.config/tsumiki und führt dann die vollständige Einrichtung durch.

Zum sofortigen Installieren und Starten:

curl -fsSL https://raw.githubusercontent.com/rubiin/tsumiki/master/install.sh | bash -s -- --start

Option 2: Automatisierte Einrichtung in vorhandenem Klon

Wenn Sie das Repository bereits manuell geklont haben, führen Sie das Setup-Skript aus:

./init.sh -setup
./init.sh -start

Das Flag -setup installiert erforderliche Systempakete und richtet die virtuelle Python-Umgebung ein.

Option 3: Manuelle Abhängigkeitseinrichtung

Sie haben die volle Kontrolle über die Pakete? Installieren Sie die Abhängigkeiten selbst und starten Sie dann:

# Systempakete installieren
sudo pacman -S --noconfirm --needed \
  pipewire playerctl dart-sass power-profiles-daemon networkmanager \
  brightnessctl pkgconf wf-recorder kitty python pacman-contrib \
  gtk3 cairo gtk-layer-shell libgirepository noto-fonts-emoji \
  gobject-introspection gobject-introspection-runtime python-pip \
  python-gobject python-psutil python-cairo python-loguru libnotify \
  cliphist libqalculate python-httpx satty nvtop

# AUR-Pakete installieren (mit yay als Beispiel)
yay -S --needed \
  python-fabric-git gnome-bluetooth-3.0 python-rlottie-python \
  python-pytomlpp slurp imagemagick tesseract tesseract-data-eng \
  ttf-jetbrains-mono-nerd grimblast-git python-ijson

# Python-Abhängigkeiten installieren
pip install -r requirements.txt

# Starten
./init.sh -start

Wenn Sie yay nicht verwenden, installieren Sie die AUR-Pakete mit Ihrem bevorzugten AUR-Helfer.

Autostart-Konfiguration

Fügen Sie diese Zeile zu Ihrer ~/.config/hypr/hyprland.conf hinzu, um Tsumiki automatisch beim Hyprland-Start zu starten:

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

Das sleep 5 stellt sicher, dass Hyprland vollständig initialisiert ist, bevor Tsumiki startet. Passen Sie den Pfad an, wenn Sie in ein anderes Verzeichnis geklont haben.

Installation überprüfen

Führen Sie ./init.sh -start aus dem Projektverzeichnis aus.
Die Tsumiki-Leiste sollte oben auf Ihrem Bildschirm erscheinen.
Wenn Sie Fehlermeldungen sehen, überprüfen Sie:
- Alle Systempakete sind installiert (./init.sh -setup wiederholt diese Prüfung)
- Python-Abhängigkeiten sind installiert (pip install -r requirements.txt)
- Sie führen Hyprland aus (nicht einen anderen Compositor oder X11)

Wenn die Leiste nicht erscheint, siehe Fehlerbehebung.

Nach der Installation

Fahren Sie fort mit Post-Installation für Hyprland-Layer-Regeln und Erste Schritte zur Konfiguration Ihres Panels.