Ir para o conteúdo
Promovaweb

Plugin OmaRGB no Omarchy

Em destaque

O que o Plugin OmaRGB faz no seu Omarchy

  1. Veja na barra a cor atual do hardware
  2. Aplique o acento do tema em todos os dispositivos
  3. Apague todas as luzes no modo discrição
  4. Ajuste modo, cor, brilho e velocidade por aparelho
  5. Acompanhe mudanças feitas no aplicativo OpenRGB
OmaRGBio.github.ilkaydnc.omargb
Tipo
Widget da barra
Categoria
Hardware
Origem
Comunidade · ilkaydnc/omargb
Mantenedor
Ilkay Dinc
Licença
MIT
Versão
0.2.1
Compatibilidade
Omarchy 4 Quattro com shell Quickshell, OpenRGB 0.9 ou mais recente e python3. A iluminação de placa-mãe e memória usa SMBus e depende do módulo i2c-dev. O catálogo registra instalação manual porque a dependência OpenRGB é instalada à parte. Referência do portal: Omarchy 4.5.0-rc1.
Tags
#barra#quickshell
Painel do OmaRGB com a lista de dispositivos OpenRGB, o seletor de cores do tema e o interruptor geral de iluminação.
Repositório ilkaydnc/omargb (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/ilkaydnc/omargb.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.ilkaydnc.omargb
  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.ilkaydnc.omargb

O OmaRGB mostra na barra uma bolinha com a cor que o seu hardware está emitindo agora e abre um painel com todos os dispositivos que o OpenRGB enxerga: teclado, mouse, mousepad, placa-mãe, memória, placa de vídeo e fitas. O painel espelha o servidor em vez de apenas enviar comandos, então uma cor trocada no aplicativo do OpenRGB ou em um jogo aparece na barra em cerca de dois segundos.

O recurso que justifica o plugin é a troca de tema. Quando você roda omarchy theme set, as luzes acompanham o acento do tema novo. O outro é o modo discrição: um clique apaga todos os dispositivos e guarda modo e cor de cada um para restaurar quando você quiser.

Antes de instalar

O OmaRGB exige Omarchy 4 Quattro, OpenRGB 0.9 ou mais recente e python3, que já vem no sistema. A ponte com o OpenRGB não tem outra dependência.

O catálogo registra a instalação como manual porque o OpenRGB é um pacote separado. O plugin oferece instalá-lo sozinho: quando falta, o painel mostra Install OpenRGB, abre um terminal, instala pelo auxiliar de pacotes do Omarchy e carrega o módulo i2c-dev. Se preferir fazer antes:

Terminal
sudo pacman -S openrgb

Placas-mãe e memórias usam SMBus e precisam de i2c-dev. O pacote carrega o módulo na próxima inicialização, e o script setup do plugin carrega na hora. Algumas placas ainda exigem o parâmetro de kernel acpi_enforce_resources=lax. Confira o wiki do OpenRGB para o seu modelo antes de acrescentar.

Instale e abra o painel

Terminal
omarchy plugin add https://github.com/ilkaydnc/omargb.git --enable

O widget entra na seção direita da barra e pode ser movido:

Terminal
omarchy bar move io.github.ilkaydnc.omargb --section center

O clique esquerdo abre o painel, o direito pinta o acento do tema em todos os dispositivos e o do meio liga ou desliga o acompanhamento do tema.

Controle os dispositivos

No painel, as amostras All devices recolorem tudo de uma vez, e a primeira amostra é o acento do tema. O interruptor no topo funciona como disjuntor geral: desligado, é o modo discrição.

Cada linha de dispositivo tem botão de energia e se expande nos controles próprios. O modo escolhe o efeito, a cor aceita amostra e controles de matiz, saturação e brilho com atualização ao vivo durante o arraste, e brilho e velocidade aparecem quando o modo oferece esses parâmetros. Save to device grava o modo na memória do controlador, para ele manter a cor depois de reiniciar.

Dois interruptores se ajustam sozinhos. Follow the theme accent desliga quando você escolhe uma cor própria ou coloca o dispositivo em um efeito do hardware, e sua escolha prevalece. O modo discrição equivale a todos os dispositivos desligados, então ligar um deles à mão desfaz o interruptor.

O acento chega saturado por padrão, porque LEDs com três canais parecidos leem como branco. A opção vividAccent desliga esse realce e envia a cor exata.

Use pelo teclado e por scripts

Com o painel aberto, j e k percorrem os dispositivos, Enter expande, h e l trocam o modo, a aplica o acento em tudo, t liga ou desliga o acompanhamento do tema, o alterna o modo discrição, r atualiza e s grava o modo do dispositivo selecionado.

O widget registra o destino IPC omargb, o que permite usar atalhos e scripts:

Terminal
omarchy-shell omargb toggle
omarchy-shell omargb applyAccent
omarchy-shell omargb stealth true
omarchy-shell omargb setAll '#ff4000'

Ajuste servidor e preferências

A ponte conversa com o servidor SDK do OpenRGB em 127.0.0.1:6742. Quando nada responde, o plugin inicia openrgb --server --noautoconnect uma vez por sessão, conforme a opção autoStartServer. Para manter o servidor fora do shell, crie uma unidade de usuário com ExecStart=/usr/bin/openrgb --server --noautoconnect e desligue a opção no widget.

As preferências ficam na entrada do plugin em ~/.config/omarchy/shell.json:

Chave Padrão Efeito
themeSync false aplica o acento do tema em todos os dispositivos quando o tema muda
vividAccent true realça a saturação antes de enviar aos LEDs
autoStartServer true inicia o servidor OpenRGB quando nada responde
host 127.0.0.1 endereço do servidor SDK
port 6742 porta do servidor SDK

Remova o OmaRGB

Terminal
omarchy plugin remove io.github.ilkaydnc.omargb

A remoção apaga a pasta do plugin e a entrada dele em ~/.config/omarchy/shell.json, que é o único arquivo que o plugin escreve. O OpenRGB continua instalado. Remova com sudo pacman -R openrgb e apague ~/.config/OpenRGB se quiser descartar as configurações dele também.

Se uma zona do dispositivo pinta a cor errada, o ajuste fica no OpenRGB e na fiação do aparelho, não no plugin. Alguns drivers de placa-mãe trocam vermelho e verde em zonas específicas, e o sintoma clássico é o modo Static correto com o Direct invertido. Efeitos como Wave e Spectrum Cycle rodam dentro do controlador, cada zona no próprio ciclo, sem leitura possível pelo OpenRGB.