Premiers Pas

Vous avez installé Tsumiki et appliqué les étapes de Post Installation. Voici comment obtenir un panneau fonctionnel rapidement.

1. Démarrer le Panneau

Depuis le répertoire du projet Tsumiki, exécutez :

./init.sh -start

Si Hyprland est en cours d’exécution, la barre devrait apparaître en haut de votre écran. Si la barre n’apparaît pas, vérifiez la sortie d’erreur dans le terminal et consultez Dépannage.

Astuce

Vous pouvez arrêter Tsumiki à tout moment avec :

pkill tsumiki

2. Configurer le Démarrage Automatique

Ajoutez Tsumiki à votre configuration Hyprland pour qu’il se lance automatiquement à la connexion :

Ouvrez ~/.config/hypr/hyprland.conf et ajoutez :

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

Le délai sleep 5 donne le temps à Hyprland de s’initialiser complètement. Ajustez le chemin si vous avez cloné Tsumiki dans un répertoire différent.

3. Copier la Configuration Exemple

Tsumiki est livré avec une configuration exemple complète. Copiez-la pour obtenir un point de départ valide :

cp example/config.toml config.toml

Astuce

Ouvrez example/config.toml dans un éditeur de texte pour voir toutes les options disponibles avec documentation.

4. Personnaliser Votre Disposition

Modifiez config.toml et ajustez la section [layout]. Chaque section (left_section, middle_section, right_section) est un tableau de noms de widgets :

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

Cela crée une barre avec :

Section	Widgets
Gauche	Sélecteur d’espaces de travail, titre de la fenêtre active
Centre	Date et heure actuelles
Droite	Contrôle du volume, état de la batterie, barre système, menu d’alimentation

5. Recharger pour Appliquer les Modifications

Après avoir enregistré vos modifications, redémarrez Tsumiki :

pkill tsumiki
./init.sh -start

Si la configuration est valide, la barre devrait réapparaître avec votre nouvelle disposition.

6. Tester les Widgets Courants

Essayez d’interagir avec vos widgets :

• Espaces de travail — Cliquez pour changer, faites défiler pour parcourir les bureaux.
• Volume — Cliquez pour couper/rétablir le son, faites défiler pour ajuster.
• Batterie — Survolez pour voir le temps restant et l’état de charge.
• Date/Heure — Cliquez pour ouvrir le calendrier et le panneau de notifications.
• Barre système — Les icônes de la barre système devraient apparaître automatiquement.

7. Personnalisez-le

• Changez les couleurs — Voir Création de Thèmes pour la personnalisation SCSS ou Matugen pour une thématisation automatique basée sur le fond d’écran.
• Ajoutez plus de widgets — Parcourez la Référence des Widgets pour les plus de 45 widgets disponibles.
• Activez des modules — Essayez le Dock, le Lanceur d’Applications ou l’OSD.
• Configurez le comportement — Voir la référence complète de Configuration pour chaque option.

Dépannage

Si quelque chose semble incorrect :

• La barre n’apparaît pas — Vérifiez que vous exécutez Hyprland et qu’aucune autre barre n’est en cours d’exécution (pkill waybar).
• Pas d’icônes — Vérifiez que JetBrains Nerd Font est installée et configurée comme police de votre terminal/UI.
• Fonctionnalité manquante — Certains widgets nécessitent des outils externes (ex., playerctl pour les médias, brightnessctl pour la luminosité). Exécutez ./init.sh -setup pour vous assurer que toutes les dépendances sont installées.
• Erreurs SASS — Votre config.toml peut être invalide. Comparez-le avec example/config.toml.

Pour plus d’aide, consultez les pages FAQ ou Dépannage.