Plugin HyprCapture no Omarchy

O HyprCapture junta captura de tela e gravação em uma única sobreposição. O trabalho é dividido entre duas partes: um plugin do compositor que captura artefatos congelados do Hyprland e um auxiliar em Qt que desenha a seleção, monta a imagem final, conversa com a área de transferência e mostra a miniatura do resultado.

Como a captura sai do próprio compositor, ela alcança janelas ocluídas ou parcialmente fora da tela, que uma captura comum perderia. E o fundo da sobreposição é uma imagem congelada do desktop, então você escolhe a área com o cenário parado à vista.

Antes de instalar

O plugin é feito só para Hyprland 0.56 ou mais recente e compila contra os headers da versão exata que está rodando. Isso significa que ele precisa de ferramentas de compilação no sistema: cmake, um compilador com C++23, nlohmann-json, Qt 6 com Core, Gui, Widgets, Svg, DBus e Network, LayerShellQt, OpenCV para registro de imagem, headers do PipeWire e do libpulse, além de FFmpeg com ffprobe e os codificadores AAC e Opus para as gravações com som.

O catálogo marca o plugin como instalação manual, porque a primeira habilitação compila o código. O README avisa que plugins de compositor rodam dentro do processo do Hyprland, com permissão alta e recomenda instalar só de fontes confiáveis. A licença é GPL-3.0-only.

Instale

A linha abaixo instala as ferramentas de compilação e as bibliotecas, depois adiciona o plugin. O pacman solicita a sua senha.

1
sudo pacman -Syu --needed base-devel cmake git cpio hyprland nlohmann-json lua glib2 \
2
    qt6-base qt6-svg qt6-wayland layer-shell-qt opencv \
3
    pipewire libpipewire fftw libpulse ffmpeg wl-clipboard
4
omarchy plugin add https://github.com/gfhdhytghd/HyprCapture.git --enable

Na primeira habilitação, um terminal abre, instala o que faltar e compila o plugin e o auxiliar. A compilação fica em ~/.cache/io.github.gfhdhytghd.hyprcapture/ e nada é instalado no sistema inteiro. Esse mesmo terminal pergunta se o HyprCapture deve assumir as entradas Screenshot e Screenrecord do menu do Omarchy: se você aceitar, um bloco marcado é acrescentado em ~/.config/omarchy/extensions/omarchy-menu.jsonc e retirado quando o plugin for desligado ou removido.

Capture pelo teclado

Ao terminar a compilação, os vínculos abaixo entram em vigor na sessão:

Um vínculo que você já tinha definido não é tomado: o plugin pula a tecla e registra isso no log. Se o HyprCapture não estiver carregado, por exemplo logo depois de uma atualização do Hyprland, as entradas do menu voltam a chamar as ferramentas do próprio Omarchy.

Escolha os seus atalhos

Para trocar teclas e ajustar o comportamento, copie o arquivo de padrões do repositório para o seu home e edite:

1
mkdir -p ~/.config/hyprcapture
2
cp ~/.config/omarchy/plugins/io.github.gfhdhytghd.hyprcapture/omarchy/defaults.lua \
3
   ~/.config/hyprcapture/omarchy.lua

Quando esse arquivo existe, ele substitui os padrões e é aplicado depois de cada recarga de configuração. As opções do plugin entram em plugin.hyprcapture nesse arquivo, não no hyprland.lua, porque o plugin ainda não está carregado quando a configuração principal roda pela primeira vez.

Grave o desktop

O modo de gravação usa o mesmo caminho da captura: seleção de alvo, sobreposição e miniatura ao final. A saída pode ser vídeo ou uma animação de duração fixa em GIF, APNG ou WebP. A gravação não depende de wf-recorder, grim, screencopy, portais do PipeWire ou sessões de compartilhamento do Hyprland.

Quando a tela usa HDR, a sobreposição e a edição acompanham. A exportação pode gerar HEIC com gain map, compatível com visualizadores comuns. Os controles de HDR só aparecem quando existe saída HDR ativa e o codificador disponível. Sem isso, a captura segue em SDR como PNG.

Mantenha depois de atualizar o Hyprland

Depois de uma atualização do Hyprland, uma notificação oferece recompilar. O comando de atualização do plugin busca versões novas e solicita a recompilação só quando o código nativo mudou:

1
omarchy plugin update io.github.gfhdhytghd.hyprcapture

Com uma instalação anterior pelo hyprpm, rode hyprpm disable hyprcapture para deixar apenas uma cópia carregada. Para conferir o estado:

1
hyprctl plugin list
2
test -x "$HOME/.local/bin/hyprcapture-ui" && echo "auxiliar instalado"

Remova o plugin

1
omarchy plugin remove io.github.gfhdhytghd.hyprcapture
2
rm -rf ~/.cache/io.github.gfhdhytghd.hyprcapture

A remoção descarrega o plugin, devolve os vínculos e as entradas de menu ao Omarchy e apaga a cópia local do repositório. O segundo comando libera o espaço da compilação. O arquivo ~/.config/hyprcapture/omarchy.lua que você criou também pode ser apagado, porque não pertence ao plugin.