Pular para o conteúdo

Configuração Avançada

Depois de se sentir confortável com o básico da Configuração, estes padrões ajudam você a ajustar ainda mais o Tsumiki.

Widgets personalizados compatíveis com Waybar que executam comandos shell externos com análise de saída configurável e manipulação de cliques.

[[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"]

Opções completas de configuração:

Chave Tipo Padrão Descrição
id string — Identificador único para referência no layout (@custom_widget:meu-id)
exec string — Comando shell a ser executado; omita para um botão só de clique
exec_if string — Executa exec apenas quando este comando termina com código 0
hide_empty_text bool false Oculta o widget quando a saída está vazia
icon string — Glifo de ícone estático, equivalente a format_icons.default
interval int 0 Intervalo de atualização em milissegundos (0 = executar uma vez)
return_type string "plain" Formato de saída: "plain" ou "json"
label_format string "{}" String de formato onde {} é substituído pela saída
format string — O nome de label_format no Waybar
exec_on_event bool false Reexecutar comando após clique/rolagem
max_length int 0 Comprimento máximo do texto (0 = sem limite)
min_length int 0 Comprimento mínimo do texto (preenche com espaços)
rotate int 0 Rotacionar texto em graus
tooltip bool true Mostrar dica de ferramenta com a saída
tooltip_format string — String de formato da dica de ferramenta
tooltip_text string — Dica estática, para um widget cuja saída nunca muda
on_click string — Comando de clique esquerdo
on_click_right string — Comando de clique direito
on_click_middle string — Comando de clique do meio
on_scroll_up string — Comando de rolagem para cima
on_scroll_down string — Comando de rolagem para baixo
signal int — Número do sinal para gatilhos de eventos sig*
restart_interval int — Intervalo de reinicialização para scripts persistentes

Agrupe widgets com espaçamento e estilo compartilhados: Referencie um grupo em seu layout com @group:N (índice baseado em zero) ou @group:id (identificador de texto):

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

Referencie no layout com @group:sys-group.

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

Oculte widgets menos usados atrás de uma alternância:

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

Referencie no layout com @collapsible:utility-tools.

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