Ir para o conteúdo
Promovaweb

Plugin omacursor no Omarchy

Em destaque

O que o Plugin omacursor faz no seu Omarchy

  1. Recolore o cursor com a paleta do tema ativo
  2. Alterne entre contorno e preenchimento com um clique
  3. Veja o modo ativo na dica do ícone
  4. Mantenha a escolha entre reinícios do sistema
  5. Devolva o cursor padrão ao desabilitar o plugin
omacursorio.github.berrimi.omacursor
Tipo
Widget da barra
Categoria
Sistema
Origem
Comunidade · berrimi/omacursor
Mantenedor
berrimi
Licença
MIT
Versão
0.1.0
Compatibilidade
Hyprland com `hyprctl` e a API Lua do Omarchy, que expõe `hl.dsp.cursor.move`, mais Python 3.11 ou mais recente com a biblioteca padrão. O plugin não instala pacote de sistema, não habilita serviço e não altera arquivos de configuração. Referência do portal: Omarchy 4.5.0-rc1.
Tags
#barra#quickshell#sistema
Barra do Omarchy com o ícone do omacursor e o ponteiro recolorido com borda de destaque e interior na cor de fundo do tema.
Repositório berrimi/omacursor (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/berrimi/omacursor.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.berrimi.omacursor
  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.berrimi.omacursor

O omacursor recolore o cursor do sistema com a paleta do tema ativo do Omarchy. A composição combina borda na cor de destaque e interior na cor de fundo, então o ponteiro acompanha a interface em vez de manter o branco padrão sobre uma barra colorida.

Um clique no ícone da barra inverte a composição e deixa o cursor preenchido com a cor de destaque. A versão preenchida usa a cor de destaque em toda a área do ponteiro, com mais peso visual que a variante de contorno. A dica que aparece ao passar o mouse informa o modo ativo, o que poupa o clique de conferência toda vez que você volta ao computador.

O serviço observa a paleta do Omarchy. Quando o tema muda, o plugin lê as cores novas e reaplica o cursor sozinho, mantendo a variante escolhida. Cada variante é montada uma vez e fica no disco, então a alternância entre as duas responde na hora depois da primeira montagem.

Antes de instalar

O plugin exige Hyprland com hyprctl e a API Lua do Omarchy, que oferece a chamada hl.dsp.cursor.move, além de Python 3.11 ou mais recente, usado apenas com a biblioteca padrão. Não há pacote de sistema para instalar, serviço para habilitar ou arquivo de configuração para editar, e a troca de tema não exige reconfigurar nada no plugin.

Instale

Terminal
omarchy plugin add https://github.com/berrimi/omacursor.git --enable

O README usa a mesma linha com --yes no final para dispensar a confirmação da instalação. Depois disso, o ícone aparece no lado direito da barra.

Use o botão da barra

Ação Resultado
clique esquerdo no ícone alterna entre cursor com contorno e cursor preenchido
passar o mouse sobre o ícone a dica mostra qual variante está ativa

A escolha sobrevive a reinícios do shell e do sistema, gravada em ~/.local/state/omacursor/settings.toml. Desabilitar ou remover o plugin devolve o cursor padrão automaticamente, o que deixa o sistema no estado anterior à instalação.

Como o cursor é montado

Service.qml observa a paleta do Omarchy e reaplica o tema do cursor quando as cores mudam. BarWidget.qml desenha o ícone e responde ao clique. scripts/theme-cursor.py monta um tema Xcursor temporário com as cores atuais: apply-omarchy lê as cores do Omarchy e aplica, restore devolve o tema e o tamanho anteriores. assets/cursor.svg é a silhueta branca que a barra colore.

O Python entra só nesse script, que lê as cores, monta o tema e o aplica sem dependência externa. A primeira troca de cada variante paga o custo da montagem. Depois disso, as duas versões prontas ficam no disco e o clique apenas alterna entre elas.

O motor de tema veio do projeto Big Cheese, de J. S. Brown (OldJobobo), também MIT. Os créditos continuam no repositório. O restore também devolve o tamanho que você usava antes da troca.

Atualize e remova

Terminal
omarchy plugin update io.github.berrimi.omacursor
omarchy plugin disable io.github.berrimi.omacursor
omarchy plugin remove io.github.berrimi.omacursor

A remoção devolve o cursor padrão. O arquivo de preferência fica em ~/.local/state, fora do diretório do plugin, então ele permanece no disco depois da remoção. Apague o arquivo à parte para que a próxima instalação comece no modo com contorno.