Plugin Stage no Omarchy

O Stage abre uma visão geral dos workspaces do monitor em foco. Cada área aparece em uma prévia ao vivo, com o conteúdo real das janelas capturado pela tela, inclusive de workspaces que você não está vendo. O workspace selecionado se amplia e os outros ficam inclinados ao lado, no mesmo formato do seletor de temas do Omarchy.

Aperte o atalho configurado e o Stage aparece. Use Esc, um clique fora da área ou um deslize para baixo para fechar. Se o Stage abrir por engano no meio de uma tarefa, o segundo Esc fecha normalmente.

Antes de instalar

O Stage exige Omarchy 4 com a configuração Lua do Hyprland e o shell baseado em Quickshell. As ações de pular para uma janela e mover painéis são chunks Lua enviados ao Hyprland, então uma configuração no formato antigo, em hyprlang, faz o plugin abrir sem executar essas ações. Nesse caso o Stage avisa uma vez ao carregar e o Quickshell registra cada chamada recusada.

As prévias custam memória de vídeo: cada workspace visível mantém uma captura atualizada da tela. Em máquinas modestas, prefira o estilo cards de cartões fixos e mantenha menos workspaces abertos.

Instale e escolha o atalho

1
omarchy plugin add https://github.com/zzwong/omarchy-stage.git --enable

O plugin não define atalho. O Super+Tab do Omarchy já alterna workspaces, então o README sugere Super+`, logo acima do Tab. Acrescente em ~/.config/hypr/bindings.lua:

1
o.bind("SUPER + GRAVE", "Stage", "omarchy-shell shell toggle zzwong.stage")

Em touchpad, o gesto de três dedos combina com a visão geral. O gesto é configuração sua e fica em ~/.config/hypr/input.lua:

1
hl.gesture({
2
  fingers = 3,
3
  direction = "up",
4
  action = function() hl.exec_cmd("omarchy-shell shell toggle zzwong.stage") end,
5
})
6
hl.gesture({
7
  fingers = 3,
8
  direction = "down",
9
  action = function() hl.exec_cmd("omarchy-shell shell hide zzwong.stage") end,
10
})

Percorra workspaces e janelas

As setas esquerda e direita, Tab e Shift+Tab percorrem os workspaces. Enter pula para o selecionado e as teclas 1 a 9 vão direto para a área correspondente. Clicar em uma fatia também seleciona, e clicar na prévia ampliada pula para a janela daquele ponto.

As setas para cima e para baixo controlam o zoom em três níveis: grade, carrossel e janelas do workspace. Na grade, as setas andam no espaço e sair pela borda superior ou inferior devolve ao carrossel. No carrossel, a seta para baixo entra nas janelas do workspace, as laterais percorrem essas janelas, Enter foca a escolhida e a seta para cima volta.

Mova e feche janelas

Na grade, arraste a miniatura de uma janela para o cartão de outro workspace ou para o espaço +, que cria a próxima área livre. A janela não sai do lugar enquanto você arrasta, o desktop continua onde estava e o Stage fica aberto. Um indicador marca o cartão que vai receber a janela, e Esc cancela o gesto sem fechar o Stage.

O compositor aplica as recusas: janela agrupada, oculta, removida durante o arraste ou destinada a outro monitor não se move. Janelas flutuantes e em tela cheia se movem normalmente. Workspace que deixou de existir não é recriado, exceto pelo espaço +.

Para fechar, use o × que aparece ao passar o mouse sobre a miniatura ou pressione X no modo de janelas. O fechamento usa a solicitação normal do Hyprland, sem forçar o encerramento, e o Stage continua aberto. Programas com alterações não salvas podem solicitar confirmação na janela deles. Segurar X não fecha outra janela por engano.

No modo de janelas, Shift com as setas troca a janela selecionada pela vizinha naquela direção, e Ctrl+Shift com as setas laterais envia a janela para o workspace seguinte na fileira, sem sair do Stage. A seleção acompanha a janela depois da troca e o ponteiro volta para onde estava.

Abaixo do carrossel, cada janela tem uma pílula. Janelas com player MPRIS mostram capa, artista e faixa, com botão de play e pause que funciona ali mesmo. Janelas que emitem áudio sem MPRIS recebem um selo de alto-falante. Clique em qualquer pílula para focar a janela.

Ajuste o comportamento em settings.json

As opções são opcionais e ficam em um arquivo próprio, relido cada vez que o Stage abre:

1
cp ~/.config/omarchy/plugins/zzwong.stage/settings.example.json \
2
   ~/.config/omarchy/plugins/zzwong.stage/settings.json

No modo cycle, você mantém Super apertado, usa o atalho para andar e solta para ir ao workspace escolhido. Parar por dez segundos desarma o salto e Enter continua valendo. Para mover a seleção com o Stage já aberto, use um atalho com step:

1
o.bind("SUPER + TAB", "Stage",
2
  "omarchy-shell shell summon zzwong.stage '{\"step\":1}'")

O Stage mostra somente workspaces do monitor focado e ignora workspaces especiais. As cores vêm do tema atual, então omarchy theme set recolore a visão geral junto com o resto do sistema.

Remova o Stage

1
omarchy plugin remove zzwong.stage

Depois apague o atalho e os gestos que você acrescentou em bindings.lua e input.lua.