Installation

Prérequis

Assurez-vous que ces éléments sont installés avant de continuer :

Prérequis	Commande d’installation (Arch Linux)	Remarques
Hyprland	`sudo pacman -S hyprland`	Instance Hyprland en cours requise
JetBrains Nerd Font	`sudo pacman -S ttf-jetbrains-mono-nerd`	Nécessaire pour le rendu des icônes
Python 3.12+	`sudo pacman -S python`	Vérifier : `python --version`
Git	`sudo pacman -S git`	Requis pour le clonage
NetworkManager	`sudo pacman -S networkmanager`	Requis par les widgets réseau
PipeWire	`sudo pacman -S pipewire pipewire-pulse`	Requis par les widgets audio

Cloner

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

Dernière Version

Version :v4.8.4Date :2026-09-28

Pour les notes de version complètes et les assets, voir la page des versions sur GitHub.

Options d’Installation

Choisissez l’une des trois méthodes suivantes.

Option 1 : Script Bootstrap (Le Plus Rapide)

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

Ce script clone ou met à jour ~/.config/tsumiki, puis exécute la configuration complète.

Pour installer et démarrer immédiatement :

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

Option 2 : Configuration Automatisée dans un Clone Existant

Si vous avez déjà cloné le dépôt manuellement, exécutez le script de configuration :

./tsumiki.sh -setup
./tsumiki.sh -start

Le drapeau -setup installe les paquets système nécessaires et configure l’environnement virtuel Python.

Option 3 : Configuration Manuelle des Dépendances

Vous préférez un contrôle total sur les paquets ? Installez les dépendances vous-même puis démarrez :

# Installer les paquets système
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 uv \
  libnotify cliphist libqalculate satty nvtop

# Installer les paquets AUR (en utilisant yay comme exemple)
yay -S --needed \
  fabric-cli-git gnome-bluetooth-3.0 \
  slurp imagemagick tesseract tesseract-data-eng \
  ttf-jetbrains-mono-nerd grimblast-git matugen-bin cinnamon-desktop

# Installer les dépendances Python
uv sync

# Démarrer
./tsumiki.sh -start

Si vous n’utilisez pas yay, installez les paquets AUR avec votre assistant AUR préféré.

Configuration du Démarrage Automatique

Ajoutez cette ligne à votre ~/.config/hypr/hyprland.conf pour lancer Tsumiki automatiquement au démarrage d’Hyprland :

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

Le sleep 5 garantit qu’Hyprland est complètement initialisé avant le lancement de Tsumiki. Ajustez le chemin si vous avez cloné dans un emplacement différent.

Vérifier l’Installation

Exécutez ./tsumiki.sh -start depuis le répertoire du projet.
La barre Tsumiki devrait apparaître en haut de votre écran.
Si vous voyez des messages d’erreur, vérifiez que :
- Tous les paquets système sont installés (./tsumiki.sh -setup réexécute cette vérification)
- Les dépendances Python sont installées (uv sync)
- Vous êtes sous Hyprland (pas un autre compositeur ou X11)

Si la barre n’apparaît pas, consultez Dépannage.

Après l’Installation

Continuez avec Post Installation pour les règles de couche Hyprland et Premiers Pas pour configurer votre panneau.