Ir al contenido

Configuración Avanzada

Una vez que te sientas cómodo con los conceptos básicos de Configuración, estos patrones te ayudarán a ajustar Tsumiki aún más.

Widgets personalizados compatibles con Waybar que ejecutan comandos shell externos con análisis de salida configurable y manejo de clics.

[[widgets.custom_widget]]
id = "volume"
exec = "pamixer --get-volume"
label_format = "󰕾 {}%"
interval = 1000
on_scroll_up = "pamixer -i 5"
on_scroll_down = "pamixer -d 5"
exec_on_event = true
[layout]
left_section = ["@custom_widget:volume", "workspaces"]

Opciones de configuración completas:

Clave Tipo Predeterminado Descripción
id string — Identificador único para referenciar en el diseño (@custom_widget:mi-id)
exec string — Comando shell a ejecutar; omítalo para un botón solo de clic
exec_if string — Ejecuta exec solo cuando este comando finaliza con código 0
hide_empty_text bool false Oculta el widget cuando la salida está vacía
icon string — Glifo de icono estático, equivalente a format_icons.default
interval int 0 Intervalo de actualización en milisegundos (0 = ejecutar una vez)
return_type string "plain" Formato de salida: "plain" o "json"
label_format string "{}" Cadena de formato donde {} se reemplaza con la salida
format string — El nombre de label_format en Waybar
exec_on_event bool false Re-ejecutar comando después de clic/desplazamiento
max_length int 0 Longitud máxima de texto (0 = sin límite)
min_length int 0 Longitud mínima de texto (rellena con espacios)
rotate int 0 Rotar texto en grados
tooltip bool true Mostrar tooltip con la salida
tooltip_format string — Cadena de formato del tooltip
tooltip_text string — Tooltip estático, para un widget cuya salida nunca cambia
on_click string — Comando de clic izquierdo
on_click_right string — Comando de clic derecho
on_click_middle string — Comando de clic medio
on_scroll_up string — Comando de desplazamiento hacia arriba
on_scroll_down string — Comando de desplazamiento hacia abajo
signal int — Número de señal para activadores de eventos sig*
restart_interval int — Intervalo de reinicio para scripts persistentes

Agrupa widgets con espaciado y estilo compartidos: Referencia un grupo en tu diseño con @group:N (índice basado en cero) o @group:id (identificador textual) :

[[widget_groups]]
id = "sys-group"
widgets = ["updates", "battery"]
spacing = 4
style_classes = ["bordered"]

Referencia en el diseño con @group:sys-group.

[layout]
right_section = ["@group:sys-group", "system_tray"]

Oculta widgets menos usados detrás de un alternador:

[[collapsible_groups]]
id = "utility-tools"
widgets = ["ocr", "screenshot", "recorder"]
spacing = 4
label_format = "󰍽"
tooltip = "Utilidades"
style_classes = ["utility-tools"]

Referencia en el diseño con @collapsible:utility-tools.

right_section = ["@collapsible:utility-tools", "system_tray"]