Plugin omalt-tab no Omarchy

O omalt-tab é um alternador de janelas para o Omarchy que resolve um incômodo antigo dos compositores Wayland. Quando você segura Alt e aperta Tab, ele tira uma fotografia das janelas e dos workspaces e mantém essa lista em memória. As teclas seguintes apenas mudam a seleção dentro da sobreposição. O foco é entregue de uma vez, quando você solta o Alt.

No uso rápido, isso economiza correções. Em um alternador que troca o foco a cada tecla, um toque errado já mudou de janela e o compositor precisa desfazer. Aqui nada acontece até o modificador subir ou até você apertar Enter. Alt+Shift+Tab anda na direção contrária.

Antes de instalar

O plugin exige Omarchy 4 com o shell Quickshell e o Hyprland configurado em Lua. As teclas chegam por um submapa em hypr/bindings.lua, dentro da pasta do próprio plugin, então o seu ~/.config/hypr/bindings.lua precisa carregar esse arquivo. Você pode usar o carregador automático de plugins ou um dofile com o caminho do omalt-tab.

A comunicação com a sobreposição usa um socket em $XDG_RUNTIME_DIR/omalt-tab.sock, com queda para o IPC do shell do Omarchy quando o socket não responde.

Instale

1
omarchy plugin add https://github.com/Codesmith28/omalt-tab.git --enable

Carregue as teclas

O caminho mais simples é carregar o bindings.lua de cada plugin instalado. Acrescente em ~/.config/hypr/bindings.lua:

1
local plugins_dir = os.getenv("HOME") .. "/.config/omarchy/plugins"
2
local p = io.popen("find " .. plugins_dir .. " -maxdepth 3 -name 'bindings.lua' 2>/dev/null")
3
if p then
4
  for file in p:lines() do
5
    dofile(file)
6
  end
7
  p:close()
8
end

Para carregar apenas o omalt-tab, use o caminho direto:

1
local omalt_tab = os.getenv("HOME") .. "/.config/omarchy/plugins/io.github.codesmith28.omalt-tab/hypr/bindings.lua"
2
local f = io.open(omalt_tab, "r")
3
if f then
4
  f:close()
5
  dofile(omalt_tab)
6
end

Navegue

Alt+Tab percorre as janelas na ordem de uso mais recente. Soltar o Alt confirma. Enter e Espaço também confirmam, o que serve no modo de desenvolvimento. Esc ou um clique fora cancelam sem trocar o foco.

As letras da fileira central pulam direto para um workspace, sem percorrer os vizinhos. Os números focam a janela daquele índice dentro do workspace ativo.

Veja a disposição

Cada workspace aparece como uma miniatura com a proporção real do monitor, inclusive em ultrawide e em tela na vertical. O contorno de cada janela segue a posição e o tamanho que ela ocupa na tela, com compensação da barra superior.

Acima de seis workspaces, a sobreposição se divide em duas fileiras, com a segunda deslocada meia largura de cartão em relação à primeira. As setas para cima e para baixo andam entre as fileiras. Workspaces vazios entre os ativos aparecem como cartões limpos, e você pode pular para eles.

Grupos de janelas do Hyprland ganham uma barra de abas no cartão, com o ícone de cada membro e destaque na aba ativa. As setas laterais percorrem essas abas antes de sair do grupo. Em vários monitores, a sobreposição abre no monitor onde está o cursor.

As cores vêm do tema ativo do Omarchy: fundo, destaque, tipografia e raio de canto acompanham a paleta. Títulos de janela entram como texto puro, sem interpretar HTML, e caracteres de direção Unicode são removidos antes da exibição.

Modo de desenvolvimento

O projeto traz um Makefile. make dev cria um link simbólico em ~/.config/omarchy/plugins/io.github.codesmith28.omalt-tab, liga o modo de desenvolvimento com o arquivo .dev e recarrega o shell. Nesse modo a sobreposição continua aberta depois de soltar o Alt e exige Enter para trocar de janela. make prod volta ao comportamento de release, make status mostra o modo ativo e o estado do socket, e make test roda os testes de modelo, navegação e segurança.

Atualize e remova

1
omarchy plugin update io.github.codesmith28.omalt-tab
2
omarchy plugin remove io.github.codesmith28.omalt-tab

A remoção tira o plugin, mas não mexe no seu bindings.lua. Com o carregador automático, nada mais precisa ser feito. Se colou o bloco explícito, apague as linhas do omalt-tab. Com a instalação por clone, make uninstall na pasta do projeto limpa os atalhos e os links auxiliares.