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.
Widget Personalizado
Seção intitulada “Widget Personalizado”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 = 1000on_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 |
Grupos de Widgets
Seção intitulada “Grupos de Widgets”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 = 4style_classes = ["bordered"]Referencie no layout com @group:sys-group.
[layout]right_section = ["@group:sys-group", "system_tray"]Grupos Recolhíveis
Seção intitulada “Grupos Recolhíveis”Oculte widgets menos usados atrás de uma alternância:
[[collapsible_groups]]id = "utility-tools"widgets = ["ocr", "screenshot", "recorder"]spacing = 4label_format = ""tooltip = "Ferramentas"style_classes = ["utility-tools"]Referencie no layout com @collapsible:utility-tools.
right_section = ["@collapsible:utility-tools", "system_tray"]