Guia de Instalação Oficial: OnLed
O OnLed foi desenvolvido originalmente no formato .deb nativo para sistemas baseados em Debian e Ubuntu. No entanto, graças à flexibilidade do Linux e à ferramenta debtap, os usuários da base Arch Linux (como Arch puro, EndeavourOS e CachyOS) também podem instalar e usar 100% das funcionalidades do aplicativo, incluindo o Modo Deus.
Abaixo, veja o passo a passo para instalar o software na sua distribuição.
1. Instalação em Sistemas Base Ubuntu / Debian
(Ubuntu, Linux Mint, Pop!_OS, Debian, Zorin OS, etc.)
Como o instalador oficial é um arquivo .deb nativo, o processo é direto e configura automaticamente todos os serviços e privilégios de hardware.
Passo 1: Baixe o arquivo onled_1.0.0.deb através do link do Mega disponibilizado.
Passo 2: Abra o terminal na pasta onde você salvou o arquivo e execute o comando abaixo para atualizar seus repositórios e instalar o pacote:
sudo apt update && sudo apt install ./onled_1.0.0.deb
(Nota: Usar o "./" antes do nome do arquivo é obrigatório para que o sistema gerencie as dependências locais corretamente).
Passo 3: O ícone do OnLed aparecerá imediatamente no menu de aplicativos do seu sistema. Ao abri-lo, o serviço em background já estará ativo.
2. Instalação em Sistemas Base Arch Linux / CachyOS
(Arch Linux, CachyOS, EndeavourOS, Manjaro, etc.)
Para instalar no Arch ou CachyOS, utilizaremos a ferramenta Debtap para converter o pacote .deb em um pacote nativo do Arch (.pkg.tar.zst), mantendo as automações de pós-instalação funcionando perfeitamente.
Passo 1: Instalar o Debtap. Em distribuições modernas como o CachyOS ou Manjaro, ele já está nos repositórios oficiais. Você pode instalar usando o Pacman no terminal ou a interface gráfica do Pamac.
Opção pelo Terminal (Pacman): Abra o terminal e digite: sudo pacman -S debtap
Opção Gráfica (Pamac / "Adicionar/Remover Programas"): Abra o Pamac, pesquise por "debtap", clique em Instalar e depois em Aplicar.
Passo 2: Sincronizar a base de dados do Debtap. Antes de converter o app pela primeira vez, digite o comando abaixo no terminal para atualizar as tabelas de conversão: sudo debtap -u
Passo 3: Converter o pacote. No terminal, navegue até a pasta onde deixou o arquivo baixado do OnLed e digite: debtap onled_1.0.0.deb
(Durante o processo, o terminal fará algumas perguntas sobre nome e licença. Você pode apenas apertar ENTER em todas elas para aceitar os padrões).
Ao terminar, um novo arquivo chamado onled-1.0.0-1-any.pkg.tar.zst terá sido gerado na mesma pasta.
Passo 4: Instalar o pacote gerado. Use o pacman com o parâmetro -U para instalar esse novo arquivo convertido: sudo pacman -U onled-1.0.0-1-any.pkg.tar.zst
Passo 5: Inicialização do serviço em background. Por segurança, o Arch Linux não inicia novos serviços automaticamente após a instalação. Para ativar o monitoramento do teclado imediatamente, digite estes três comandos em sequência no terminal:
sudo systemctl daemon-reload
sudo systemctl enable keyboard-led.service
sudo systemctl start keyboard-led.service
Como verificar se está tudo funcionando?
Independente da sua distribuição, após concluir os passos:
Procure por "OnLed" no menu do seu sistema. O aplicativo abrirá exibindo o ícone na barra de tarefas.
Acesse a aba "Modo Deus" e confirme se o status exibe a mensagem de ativado com a bolinha verde.
Se quiser que ele ligue sozinho sempre que o PC iniciar, basta marcar a caixinha de inicialização minimizada dentro do painel.