Aperçu
Qu’est-ce que Tsumiki ?
Section intitulée « Qu’est-ce que Tsumiki ? »Tsumiki (anciennement Hydepanel) est une barre d’état modulaire pour le compositeur Wayland Hyprland. Construit sur le système de widgets Fabric, il offre une architecture flexible pour créer des panneaux de bureau personnalisés grâce à des widgets composites.
Le nom Tsumiki (積み木) signifie “blocs de construction” en japonais — reflétant la conception modulaire et empilable du projet.
Prérequis
Section intitulée « Prérequis »Avant d’installer Tsumiki, assurez-vous que votre système répond à ces exigences :
| Exigence | Remarques |
|---|---|
| Hyprland | Une installation fonctionnelle d’Hyprland est requise |
| JetBrains Nerd Font | Nécessaire pour le rendu des icônes et glyphes |
| Python 3.12+ | Tsumiki cible Python 3.12 |
| Arch Linux (recommandé) | Paquets optimisés pour Arch ; autres distributions peuvent nécessiter une configuration manuelle |
| NetworkManager | Requis pour les widgets et services réseau |
| PipeWire | Requis pour les widgets audio et l’OSD |
Concepts Clés
Section intitulée « Concepts Clés »Les widgets sont les blocs de construction individuels qui apparaissent dans la barre. Plus de 45 widgets intégrés couvrent :
- Infos système — CPU, mémoire, GPU, stockage, utilisation réseau
- Contrôle matériel — Volume, luminosité, microphone, batterie
- Gestion du bureau — Espaces de travail, titre de fenêtre, barre des tâches
- Utilitaires — Capture d’écran, OCR, presse-papiers, enregistrement d’écran
- Productivité — Minuterie Pomodoro, tableau Kanban, chronomètre, sélecteur d’emoji
- Intégration — Météo, contrôles média, compagnon Git, commutateur DNS
Chaque widget est configuré sous [widgets.<nom>] dans config.toml. Voir la Référence des Widgets pour la liste complète.
Les modules sont des surfaces d’interface plus grandes qui vont au-delà de la barre — ce sont des fenêtres ou des superpositions autonomes :
- Barre — Le panneau principal lui-même
- Système de notifications — Affichage des notifications du bureau
- Dock — Dock d’applications avec intellihide
- Vue d’ensemble — Exposé des espaces de travail en plein écran
- Lanceur d’applications — Recherche d’applications pilotée par le clavier
- OSD — Affichages à l’écran pour le volume, la luminosité, etc.
- Horloge de bureau — Superposition d’horloge décorative
- Citations de bureau — Affichage de citations inspirantes
Les modules sont configurés sous [modules.<nom>] dans config.toml. Voir la Référence des Modules pour les détails.
Disposition
Section intitulée « Disposition »Le placement des widgets dans la barre est contrôlé par la section [layout] de config.toml :
[layout]left_section = ["workspaces", "window_title"]middle_section = ["date_time"]right_section = ["volume", "battery", "system_tray"]Les widgets peuvent également être regroupés ou placés dans des groupes pliables. Voir Configuration pour les détails.
Services
Section intitulée « Services »Les services sont des processus d’arrière-plan qui fournissent des données aux widgets — ils surveillent les niveaux de batterie, l’état du réseau, les lecteurs multimédias, la météo et plus encore. Les widgets se connectent aux services via des signaux GTK, ce qui maintient les mises à jour efficaces.
Architecture
Section intitulée « Architecture »L’architecture de Tsumiki suit une conception en couches :
┌──────────────────────────────────────────────┐│ main.py ││ ┌──────────┐ ┌──────────┐ ┌───────────┐ ││ │ Config │ │ CSS │ │ Module │ ││ │ Loader │ │ Compiler │ │ Init │ ││ └──────────┘ └──────────┘ └───────────┘ │└─────────────────────┬────────────────────────┘ │ ┌─────────────┼─────────────┐ ▼ ▼ ▼ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ Services │ │ Widgets │ │ Modules │ │ (DBus, │──▶│ (Panel │──▶│ (Overlay │ │ polling) │ │ buttons) │ │ windows) │ └──────────┘ └──────────┘ └──────────┘- Services s’exécutent en arrière-plan et émettent des signaux GTK lors des changements d’état
- Widgets sont des boutons du panneau qui s’abonnent aux signaux des services
- Modules sont des fenêtres GTK autonomes pour les superpositions et les popups
Voir la page Architecture pour un aperçu plus approfondi.
Parcours Recommandé
Section intitulée « Parcours Recommandé »- Installer Tsumiki — Cloner, installer les dépendances, configurer l’environnement.
- Suivre Premiers Pas — Démarrer la barre, configurer la disposition, appliquer les règles post-installation.
- Apprendre Configuration — Comprendre la structure de configuration TOML et les options disponibles.
- Choisir un thème — Commencer avec un thème intégré ou créer le vôtre avec Création de Thèmes.
- Explorer — Ajouter des widgets, activer des modules, personnaliser le comportement.