Plugin Mirador no Omarchy

O Mirador abre uma visão completa dos workspaces do Omarchy. Cada área aparece em um cartão com prévias reais das janelas, na posição e no tamanho que elas ocupam no monitor. Você troca de workspace, foca uma janela, cria uma área nova e arrasta janelas entre workspaces sem sair da visão.

O plugin tem dois modos. A visão completa mostra a grade de workspaces do monitor e serve para achar uma janela pela posição. O carrossel mostra um workspace por vez, com as janelas lado a lado, e atende a troca rápida pelo teclado.

Antes de instalar

O Mirador exige Omarchy 4 com Hyprland em Lua e o shell Quickshell. O plugin não instala atalhos sozinho: você acrescenta o bloco de bindings em ~/.config/hypr/bindings.lua, e o bloco desfaz antes os atalhos padrão que ele ocupa, como SUPER + TAB e ALT + TAB. Acrescente o bloco uma única vez e não carregue também o mirador.bindings.lua, que define os mesmos atalhos de fechar, setas e números.

Instale

1
omarchy plugin add https://github.com/sanjyay/Mirador.git --enable

Ligue o teclado

O bloco abaixo cobre o carrossel, a visão completa, o fechamento de janela e as setas. Cole em ~/.config/hypr/bindings.lua:

1
hl.unbind("SUPER + TAB")
2
hl.unbind("SUPER + SHIFT + TAB")
3
o.bind("SUPER + TAB", "Workspace carousel next", "mirador --cycle-next")
4
o.bind("SUPER + SHIFT + TAB", "Workspace carousel prev", "mirador --cycle-prev")
5

6
hl.unbind("ALT + TAB")
7
hl.unbind("ALT + SHIFT + TAB")
8
o.bind("ALT + TAB", "Workspace overview next",
9
  [[omarchy-shell shell summon mirador '{"step":1,"modifier":"alt","cycleUI":"full","keybindMode":"cycle"}']])
10
o.bind("ALT + SHIFT + TAB", "Workspace overview prev",
11
  [[omarchy-shell shell summon mirador '{"step":-1,"modifier":"alt","cycleUI":"full","keybindMode":"cycle"}']])
12

13
hl.unbind("SUPER + W")
14
o.bind("SUPER + W", "Close window", "mirador --close-window")
15

16
hl.unbind("SUPER + LEFT")
17
hl.unbind("SUPER + RIGHT")
18
hl.unbind("SUPER + UP")
19
hl.unbind("SUPER + DOWN")
20
o.bind("SUPER + LEFT", "Focus left window", "mirador --window-left")
21
o.bind("SUPER + RIGHT", "Focus right window", "mirador --window-right")
22
o.bind("SUPER + UP", "Focus upper window", "mirador --window-up")
23
o.bind("SUPER + DOWN", "Focus lower window", "mirador --window-down")
24

25
hl.unbind("SHIFT + TAB")
26
o.bind("SHIFT + TAB", "Workspace full overview", "mirador --full")

Para os números, use o laço do README, que desfaz os atalhos padrão e liga SUPER mais os códigos de tecla 10 a 19 e mantém 0 para o workspace 10:

1
for workspace = 1, 10 do
2
  local key = workspace == 10 and "0" or tostring(workspace)
3
  local keycode = "code:" .. tostring(workspace + 9)
4
  hl.unbind("SUPER + " .. key)
5
  hl.unbind("SUPER + " .. keycode)
6
  hl.unbind("SUPER + SHIFT + " .. key)
7
  hl.unbind("SUPER + SHIFT + " .. keycode)
8
  o.bind("SUPER + " .. keycode, "Navigate Mirador to workspace " .. workspace,
9
    "mirador --workspace " .. workspace)
10
  o.bind("SUPER + SHIFT + " .. keycode, "Move selected Mirador window to workspace " .. workspace,
11
    "mirador --move-window-to-workspace " .. workspace)
12
end

Recarregue e confira a configuração:

1
hyprctl reload
2
hyprctl configerrors

Navegue

Um gesto de três dedos para cima abre a visão e um para baixo fecha. Os gestos ficam em ~/.config/hypr/input.lua:

1
hl.gesture({
2
  fingers = 3,
3
  direction = "up",
4
  action = function()
5
    hl.dispatch(hl.dsp.exec_cmd("omarchy-shell shell summon mirador '{\"cycleUI\":\"full\",\"keybindMode\":\"normal\"}'"))
6
  end,
7
})

Desfoque no fundo

O desfoque do Mirador depende do motor de blur do Hyprland, que algumas instalações do Omarchy deixam desligado. Para ligar, acrescente em um arquivo seu, como ~/.config/hypr/looknfeel.lua:

1
hl.config({
2
  decoration = {
3
    blur = { enabled = true },
4
  },
5
})
6
hl.layer_rule({
7
  name = "mirador-blur",
8
  match = { namespace = "^omarchy-workspace-overview$" },
9
  blur = true,
10
})

O plugin não altera a configuração do Hyprland. Não coloque esse ajuste em arquivo gerenciado pelo Omarchy. Ligar o motor global deixa o desfoque disponível para o sistema todo, e a camada nomeada restringe o efeito ao Mirador.

Remova

1
omarchy plugin remove mirador

A remoção apaga os arquivos do plugin e não mexe no seu bindings.lua. Enquanto o bloco do Mirador estiver lá, SUPER + TAB continua desligado no Omarchy padrão. Apague o bloco inteiro, incluindo os atalhos de ALT, SUPER + W, as setas, os números e SHIFT + TAB. Com gestos adicionados em input.lua ou o desfoque em looknfeel.lua, remova essas entradas também e rode hyprctl reload.