Configuration Avancée
Une fois que vous êtes à l’aise avec les bases de la Configuration, ces modèles vous aident à affiner Tsumiki davantage.
Widget Personnalisé
Section intitulée « Widget Personnalisé »Widgets personnalisés compatibles Waybar qui exécutent des commandes shell externes avec une analyse de sortie configurable et une gestion des clics.
[[widgets.custom_widget]]id = "volume"exec = "pamixer --get-volume"label_format = " {}%"interval = 1000on_scroll_up = "pamixer -i 5"on_scroll_down = "pamixer -d 5"exec_on_event = true
[layout]left_section = ["@custom_widget:volume", "workspaces"]Options de configuration complètes :
| Clé | Type | Défaut | Description |
|---|---|---|---|
id |
string | — | Identifiant unique pour référencer dans la disposition (@custom_widget:mon-id) |
exec |
string | — | Commande shell à exécuter ; omettez pour un bouton uniquement au clic |
exec_if |
string | — | N’exécute exec que si cette commande se termine avec le code 0 |
hide_empty_text |
bool | false |
Masque le widget lorsque la sortie est vide |
icon |
string | — | Glyphe d’icône statique, équivalent à format_icons.default |
interval |
int | 0 |
Intervalle d’actualisation en millisecondes (0 = exécuter une fois) |
return_type |
string | "plain" |
Format de sortie : "plain" ou "json" |
label_format |
string | "{}" |
Chaîne de format où {} est remplacé par la sortie |
format |
string | — | Le nom de label_format chez Waybar |
exec_on_event |
bool | false |
Ré-exécuter la commande après clic/défilement |
max_length |
int | 0 |
Longueur maximale du texte (0 = pas de limite) |
min_length |
int | 0 |
Longueur minimale du texte (remplit avec des espaces) |
rotate |
int | 0 |
Rotation du texte en degrés |
tooltip |
bool | true |
Afficher l’infobulle avec la sortie |
tooltip_format |
string | — | Chaîne de format de l’infobulle |
tooltip_text |
string | — | Infobulle statique, pour un widget dont la sortie ne change jamais |
on_click |
string | — | Commande clic gauche |
on_click_right |
string | — | Commande clic droit |
on_click_middle |
string | — | Commande clic milieu |
on_scroll_up |
string | — | Commande défilement vers le haut |
on_scroll_down |
string | — | Commande défilement vers le bas |
signal |
int | — | Numéro de signal pour les déclencheurs d’événements sig* |
restart_interval |
int | — | Intervalle de redémarrage pour les scripts persistants |
Groupes de Widgets
Section intitulée « Groupes de Widgets »Regroupez les widgets avec un espacement et un style partagés :
Référencez un groupe dans votre disposition avec @group:N (index basé sur zéro) ou @group:id (identifiant textuel) :
[[widget_groups]]id = "sys-group"widgets = ["updates", "battery"]spacing = 4style_classes = ["bordered"]Référencez dans la disposition avec @group:sys-group.
[layout]right_section = ["@group:sys-group", "system_tray"]Groupes Pliables
Section intitulée « Groupes Pliables »Cachez les widgets moins utilisés derrière un bouton :
[[collapsible_groups]]id = "utility-tools"widgets = ["ocr", "screenshot", "recorder"]spacing = 4label_format = ""tooltip = "Outils utilitaires"style_classes = ["utility-tools"]Référencez dans la disposition avec @collapsible:utility-tools.
right_section = ["@collapsible:utility-tools", "system_tray"]