Plugin omacursor no Omarchy
Em destaque
O que o Plugin omacursor faz no seu Omarchy
- Recolore o cursor com a paleta do tema ativo
- Alterne entre contorno e preenchimento com um clique
- Veja o modo ativo na dica do ícone
- Mantenha a escolha entre reinícios do sistema
- Devolva o cursor padrão ao desabilitar o plugin
io.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

Instalar e manter
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 --enableAtualize 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.omacursorRemova 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
omarchy plugin add https://github.com/berrimi/omacursor.git --enableO 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
omarchy plugin update io.github.berrimi.omacursoromarchy plugin disable io.github.berrimi.omacursoromarchy plugin remove io.github.berrimi.omacursorA 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.