Plugin Hotkey Wheel no Omarchy

O Hotkey Wheel abre uma roda de ações no ponto do ponteiro enquanto você segura um botão do mouse. Você aponta para o setor desejado e solta para executar. Soltar onde começou, apertar Esc ou clicar com o botão direito cancela a escolha.

Cada setor recebe o que você quiser: um aplicativo instalado, uma ação do Omarchy, um atalho já existente na sua configuração ou um comando próprio. A roda usa as cores de menu, a borda e a tipografia do tema ativo, então ela acompanha a identidade visual da sessão sem ajuste manual.

Enquanto o botão está apertado, os outros botões do mouse não chegam à janela que está atrás da roda. Isso evita clicar por acidente no que estiver embaixo.

Antes de instalar

O plugin exige Omarchy 4 com a configuração do Hyprland em Lua. O autor testou o funcionamento em Omarchy 4.0.0 alpha, Hyprland 0.56.2 e Quickshell 0.3.1.

As ferramentas de apoio já fazem parte do Omarchy: hyprctl, bash, coreutils, grep, sed, find, awk, iconv, gtk-launch, uwsm-app, wl-copy e wl-paste. Não há pacote extra para instalar.

O botão do meio abre a roda por padrão, então o clique do meio deixa de chegar aos aplicativos, que é como você cola texto, abre um link em outra aba ou fecha uma aba. O Ctrl com o botão do meio continua funcionando como antes. Se isso atrapalhar, escolha Super + meio, Back ou Forward em Open with, no painel da roda.

Instale e configure

1
omarchy plugin add https://github.com/erikrjohansson/omarchy-hotkey-wheel.git --enable

O comando coloca o ícone da roda na barra. Para abrir a roda com o mouse, o Hyprland precisa de mais uma linha, porque é ele que decide o destino dos botões e o plugin só mexe na sua configuração quando você autoriza.

O caminho mais simples está no próprio painel: clique em Set up e ele acrescenta a linha marcada no fim de ~/.config/hypr/bindings.lua e recarrega o Hyprland, sem alterar o resto do arquivo.

Para fazer à mão, acrescente este trecho em ~/.config/hypr/bindings.lua e rode hyprctl reload:

1
do -- Hotkey Wheel, skipped once the plugin is removed
2
  local wheel = os.getenv("HOME") .. "/.config/omarchy/plugins/io.github.erikrjohansson.hotkey-wheel/bindings.lua"
3
  local file = io.open(wheel)
4
  if file then file:close(); dofile(wheel) end
5
end

Sem essa linha o painel funciona e o botão segurado não abre nada.

Monte a roda

Clique no ícone da roda (󰄦) na barra. No painel, clique em um setor ou aperte o número dele para abrir o seletor. Para trocar duas posições, arraste um setor sobre outro.

O seletor tem quatro abas pesquisáveis:

Slots define o número de setores da roda e Show names mostra ou esconde os nomes sob os ícones. As escolhas e esses dois ajustes ficam gravados quando você aperta Save ou Ctrl+S. Cancel descarta o que mudou.

Crie ações próprias

Em Create new action você informa nome, ícone, descrição e o comando de shell. Try it executa uma vez e Save it coloca a ação no setor. Nos dois casos o plugin mostra antes o comando e o script que gravou. Ele só segue adiante quando você clica em Yes.

Clicar em uma ação já gravada mostra o que ela faz, o comando e o script, além das opções de usar, renomear ou apagar.

Quando não souber o que escrever, descreva o que quer em Ask an agent e use Copy prompt no Claude Code, no Codex ou em outro agente. A resposta termina com um bloco de quatro linhas entre Name e Command: copie, abra o setor de novo e use Paste answer para preencher o formulário. Leia o comando e o script quando o plugin mostrar os dois, porque depois de gravada a ação roda como um atalho escrito por você.

Abra por teclado

Setas ou rolagem do mouse percorrem os setores, Enter ou Space executa o setor em foco e Esc fecha. Para abrir a roda por uma tecla ou por um controlador com mostrador, amarre o comando em ~/.config/hypr/bindings.lua:

1
hl.bind("F13", hl.dsp.exec_cmd("omarchy-shell shell toggle io.github.erikrjohansson.hotkey-wheel"))

Atualize e remova

1
omarchy plugin update io.github.erikrjohansson.hotkey-wheel && hyprctl reload && omarchy restart shell

Antes de desinstalar, desligue a roda no interruptor On, no canto superior direito do painel, porque desabilitar o plugin deixa o botão ainda amarrado à roda. Depois rode:

1
~/.config/omarchy/plugins/io.github.erikrjohansson.hotkey-wheel/hotkey-wheel unsetup && omarchy plugin remove io.github.erikrjohansson.hotkey-wheel

O unsetup retira a linha que o Set up acrescentou e recarrega o Hyprland. Caso o trecho tenha sido colado à mão, apague você mesmo. Os setores e as ações próprias continuam em ~/.config/omarchy/extensions/, nos arquivos hotkey-wheel*. Apague esses arquivos se não pretende voltar.