Ir para o conteúdo
Promovaweb

Plugin Keybind Toast no Omarchy

Em destaque

O que o Plugin Keybind Toast faz no seu Omarchy

  1. Veja o nome de cada atalho logo depois de usá-lo
  2. Leia descrições longas em duas linhas
  3. Escolha quais atalhos mostram o aviso
  4. Comece com cerca de 145 atalhos do Omarchy já listados
  5. Use só texto, sem coluna de ícone
Keybind Toastio.github.a3qz.keybind-toast
Tipo
Painel
Categoria
Desktop
Origem
Comunidade · a3qz/omarchy-keybind-toast
Mantenedor
a3qz
Licença
MIT
Versão
1.0.0
Compatibilidade
Omarchy com plugins do shell e configuração do Hyprland em Lua. O catálogo marca o plugin como instalação manual: além do comando de plugins, é preciso copiar o arquivo keybind-toast.lua para ~/.config/hypr/ e carregá-lo no hyprland.lua. O arquivo redeclara cerca de 145 atalhos padrão do Omarchy. Referência do portal: Omarchy 4.5.0.
Tags
#hyprland#quickshell
Caixa de texto do Keybind Toast centralizada na base da tela do Omarchy com a frase Toggle window split, sobre duas janelas de terminal lado a lado.
Repositório a3qz/omarchy-keybind-toast (MIT)

Instalar e manter

  1. Instale o plugin

    O Omarchy clona o repositório do plugin e valida os arquivos no seu computador. Só depois ele instala e ativa o plugin.

    Instalar
    omarchy plugin add https://github.com/a3qz/omarchy-keybind-toast.git --enable
  2. Atualize quando sair uma versão nova

    Rode este comando para trazer as mudanças publicadas no repositório do plugin.

    Atualizar
    omarchy plugin update io.github.a3qz.keybind-toast
  3. Remova quando não precisar mais

    O comando retira o plugin do seu Omarchy. Use o mesmo identificador mostrado no cartão de detalhes.

    Remover
    omarchy plugin remove io.github.a3qz.keybind-toast

O Keybind Toast mostra uma pequena caixa de texto na base da tela com o nome do atalho do Omarchy que você acabou de acionar: “Terminal”, “Toggle window floating/tiling”, “Focus on next window”. Você pode comparar o nome exibido com a combinação usada no teclado.

A caixa é diferente do aviso nativo de volume e brilho. Ela centraliza o texto, não reserva espaço para ícone e quebra descrições longas em uma segunda linha em vez de cortá-las.

Antes de instalar

O plugin tem duas partes. As duas são obrigatórias. A primeira é o painel do Quickshell, que desenha a caixa. A segunda é o arquivo hypr/keybind-toast.lua, que você copia para a configuração do Hyprland e que avisa o painel quando um atalho dispara.

A divisão existe porque um plugin do shell não consegue editar a configuração do Hyprland sozinho. Por isso o catálogo marca o Keybind Toast como instalação manual. Nenhuma das partes mostra erro quando a outra falta: o atalho continua funcionando, só a caixa não aparece.

Instale o painel

Terminal
omarchy plugin add https://github.com/a3qz/omarchy-keybind-toast.git --enable
omarchy restart shell

Confira se o painel está ativo. O comando abaixo deve responder ok:

Terminal
omarchy-shell keybindToast ping

Ligue a parte do Hyprland

Copie o arquivo Lua que acompanha o plugin para a pasta do Hyprland:

Terminal
cp -i ~/.config/omarchy/plugins/io.github.a3qz.keybind-toast/hypr/keybind-toast.lua \
~/.config/hypr/keybind-toast.lua

Acrescente esta linha ao ~/.config/hypr/hyprland.lua, junto das outras linhas require("hypr.*"):

require("hypr.keybind-toast")

Recarregue e confira os erros. Saída vazia em configerrors significa que o arquivo carregou:

Terminal
hyprctl reload
hyprctl configerrors

Para testar, pressione Super+Enter. A caixa com a palavra “Terminal” aparece na base da tela.

Escolha quais atalhos mostram o aviso

Abra ~/.config/hypr/keybind-toast.lua. A tabela toast_enabled, no início do arquivo, lista cada descrição que pode gerar o aviso, de aplicativos e menus a comandos de janela. Troque o valor para false para silenciar um atalho sem apagá-lo da lista.

Para incluir um atalho que ainda não está lá, procure a linha dele em /usr/share/omarchy/default/hypr/bindings/*.lua. Copie as teclas, a descrição e o comando para o arquivo do plugin, no par hl.unbind(keys) e o.bind_toast(keys, description, action), seguindo o formato das entradas existentes.

Se a caixa não aparecer

A ausência de uma das partes impede a exibição da caixa. Confira o painel e o arquivo Lua:

Terminal
omarchy plugin list --json | jq '.[] | select(.id=="io.github.a3qz.keybind-toast")'
grep keybind-toast ~/.config/hypr/hyprland.lua

O primeiro comando precisa mostrar "enabled": true. O segundo precisa mostrar a linha require.

Limites conhecidos

O arquivo Lua redeclara cerca de 145 atalhos padrão do Omarchy. Quando um atalho tem uma personalização, vale o arquivo que o Hyprland carrega por último. Carregue as suas personalizações depois do keybind-toast ou apague do arquivo do plugin o par correspondente àquele atalho.

O plugin trabalha sobre uma cópia dos atalhos e do auxiliar interno command_from() do Omarchy, porque não há API pública para isso. Depois de uma atualização do Omarchy que mude atalhos padrão, compare o arquivo com /usr/share/omarchy/default/hypr/bindings/*.lua e com o helpers.lua.

Remova

Terminal
omarchy plugin remove io.github.a3qz.keybind-toast

Depois, apague a linha require("hypr.keybind-toast") do hyprland.lua, remova o arquivo ~/.config/hypr/keybind-toast.lua e rode hyprctl reload para os atalhos voltarem ao padrão do Omarchy.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.