Ir para o conteúdo
Promovaweb

Plugin Omapop no Omarchy

Em destaque

O que o Plugin Omapop faz no seu Omarchy

  1. Selecione texto e escolha a ação na barra
  2. Copie, cole, busque ou abra o link selecionado
  3. Acrescente extensões do diretório PopClip
  4. Exija Shift nas seleções de terminal
  5. Abra a barra por atalho ou toque longo
Omapopio.github.jondkinney.omapop
Tipo
Widget da barra
Categoria
Produtividade
Origem
Comunidade · jondkinney/omapop
Mantenedor
Jon Kinney
Licença
MIT
Versão
0.4.11
Compatibilidade
Exige Hyprland 0.56 ou mais recente com a API de configuração em Lua, Quickshell, wl-clipboard, python3 com PyYAML e jq. Extensões em JavaScript também precisam de deno ou nodejs. O plugin não instala dependências sozinho. Referência do portal: Omarchy 4.5.0-rc1.
Tags
#barra#hyprland#quickshell
Barra de ações do Omapop ao lado de um texto selecionado, com os botões Cut, Copy, Paste, Search e Open Link, e o painel de extensões aberto.
Repositório jondkinney/omapop (MIT)

Instalar e manter

  1. Instale o plugin

    O Omarchy clona o repositório do plugin e valida os arquivos no seu computador. Só depois ele instala e ativa o plugin.

    Instalar
    omarchy plugin add https://github.com/jondkinney/omapop.git --enable
  2. Atualize quando sair uma versão nova

    Rode este comando para trazer as mudanças publicadas no repositório do plugin.

    Atualizar
    omarchy plugin update io.github.jondkinney.omapop
  3. Remova quando não precisar mais

    O comando retira o plugin do seu Omarchy. Use o mesmo identificador mostrado no cartão de detalhes.

    Remover
    omarchy plugin remove io.github.jondkinney.omapop

O Omapop mostra uma barra de ações ao lado do texto que você acabou de selecionar. Cut, Copy, Paste, Search, Open Link e Reveal in Files ficam a um clique, junto com as extensões que você instalar. O projeto aceita um subconjunto revisado do diretório de extensões do PopClip, com pacotes em YAML, script de shell ou JavaScript.

O plugin é QML puro sobre o Quickshell. A parte que percebe o fim de uma seleção roda como um pequeno motor Lua dentro do Hyprland, porque o compositor é o único componente do Wayland que vê a soltura do botão do mouse e a posição do ponteiro. Não há código nativo nem daemon.

Antes de instalar

Você precisa de Hyprland 0.56 ou mais recente com a API de configuração em Lua, Quickshell, wl-clipboard, python3 com PyYAML e jq. Extensões em JavaScript também exigem deno ou nodejs. Sem um dos dois, elas aparecem na lista e ficam desativadas.

O restante das ferramentas já faz parte do Omarchy: Bash e coreutils, xdg-utils, setpriv do util-linux, OpenSSL para as assinaturas do catálogo, D-Bus e gdbus do GLib. A detecção de campos editáveis usa python-gobject e at-spi2-core, que são opcionais. Quando essas ligações faltam, o auxiliar informa que a editabilidade é desconhecida e as alternativas do plugin entram em ação. O Omapop não instala dependência nenhuma sozinho.

Instale e habilite

Terminal
omarchy plugin add https://github.com/jondkinney/omapop.git --enable

O README instala sem habilitar, para você ler o código antes. A habilitação vem depois, com omarchy plugin enable io.github.jondkinney.omapop. Com --enable o plugin já entra ativo, adiciona o ícone na seção direita da barra e inicia o serviço. Depois de alterar o código do plugin, rode omarchy restart shell para o shell servir uma cópia nova.

Use a barra de ações

Arraste para selecionar um trecho, dê duplo clique em uma palavra ou triplo clique em uma linha. A barra aparece acima do ponteiro e, quando o arraste desce, aparece abaixo, para não cobrir o texto escolhido. Em terminais, segure Shift do início ao fim da seleção.

Botão Precisa de
Cut texto selecionado, campo editável e janela que não seja terminal
Copy texto selecionado
Paste texto no clipboard e um campo editável, um terminal ou um toque longo
Search texto selecionado de até 4000 caracteres
Open Link um endereço no texto, inclusive no formato spotify: ou ftp:
Reveal in Files um caminho existente como texto inteiro
Install Extension um trecho de extensão de até 5000 caracteres

Passe o mouse sobre um botão para ver o nome e clique para executar. Segure Shift, Ctrl, Alt ou Super ao clicar para a ação alternativa: Alt em Search faz busca exata, Alt em Open Link copia os endereços e Shift no Uppercase incluído produz minúsculas. Um clique simples não abre a barra. Um relatório de acessibilidade que informa seleção vazia também impede a abertura.

O toque longo chega desligado e pode ser ativado em Settings, quando você segura o botão esquerdo por meio segundo sem mover. Ele abre a barra sem seleção, por exemplo para colar, sem exigir Shift nos terminais. A barra se esconde quando você clica fora, digita, rola a tela, afasta o ponteiro ou troca de janela ou workspace. Segurar Super durante a seleção mantém a barra longe.

Ajuste a seleção e as extensões

Clique no ícone da barra para ligar e desligar extensões, editar opções, reexaminar a pasta ou abri-la. O botão direito pausa e retoma o Omapop. Em Settings, um atalho como SUPER + SHIFT + P mostra a barra para a seleção atual, o que resolve aplicativos que não publicam uma seleção primária nova.

As preferências ficam na entrada do Omapop em ~/.config/omarchy/shell.json e também podem ser alteradas por omarchy bar set:

Terminal
omarchy bar set io.github.jondkinney.omapop longPress true --json
omarchy bar set io.github.jondkinney.omapop shortcut 'SUPER + SHIFT + P'

Entre as chaves estão searchEngine e searchUrl, dragThreshold, position, assumeEditable, accessibilityProbe, hideDistance, longPress, requireTerminalShift, maxSelectionKiB, excludedApps, terminalClasses, extensionDownloads, directoryRefresh, shortcut e showBarIcon. As extensões e suas opções ficam em ~/.config/omapop/, fora da pasta do plugin. Elas sobrevivem às atualizações. O catálogo assinado do projeto aprova 189 versões exatas de pacotes. A instalação de uma extensão só acontece depois da sua confirmação, com Allow extension installs ligado.

Atualize e remova

Terminal
omarchy plugin update io.github.jondkinney.omapop
omarchy plugin disable io.github.jondkinney.omapop
omarchy plugin remove io.github.jondkinney.omapop
rm -rf ~/.config/omapop

Os vínculos que o Omapop criou no Hyprland saem na próxima recarga da configuração, com hyprctl reload. A pasta ~/.config/omapop guarda extensões e preferências e só deve ser apagada se você quiser perder essas escolhas.