Como configurar dispositivos Razer usando o RazerGenie no Linux

O RazerGenie é um aplicativo Linux de código aberto para configurar periféricos Razer compatíveis. Ele ajusta a iluminação RGB e o brilho e, em mouses compatíveis, os níveis de DPI e a taxa de polling. Ele depende do OpenRazer , portanto, o driver e o daemon devem ser instalados no host antes que o RazerGenie — especialmente sua versão Flatpak — possa detectar os dispositivos.

1. Verifique a compatibilidade e instale o OpenRazer.

Verifique o modelo exato do seu dispositivo na lista oficial de dispositivos OpenRazer . O suporte para versões estáveis ​​e de desenvolvimento pode variar, portanto, um modelo listado apenas na versão de desenvolvimento pode precisar de um pacote mais recente. Use o guia de instalação atual se a sua versão não estiver listada abaixo.

O OpenRazer usa o DKMS para construir um módulo do kernel. Instale os cabeçalhos que correspondem ao kernel em execução caso seu gerenciador de pacotes não os adicione; o Ubuntu e o Debian geralmente os instalam automaticamente.

Ubuntu, Linux Mint, sistema operacional elementar, Pop!_OS e Zorin OS

Para obter a versão estável mais recente, adicione o PPA do OpenRazer e instale o meta-pacote correspondente. No elementary OS, instale primeiro o auxiliar de PPA, se necessário.

sudo apt install software-properties-gtk
sudo add-apt-repository ppa:openrazer/stable
sudo apt update
sudo apt install openrazer-meta

O comando auxiliar destina-se principalmente ao elementary OS; execute-o em outros sistemas operacionais somente se necessário.

Fedora e Nobara 41 ou posterior

Para o Fedora 41 e versões posteriores, instale o pacote de desenvolvimento do kernel correspondente, adicione o repositório OpenRazer e instale o driver:

sudo dnf install kernel-devel
sudo dnf config-manager addrepo --from-repofile=https://openrazer.github.io/hardware:razer.repo
sudo dnf install openrazer-meta

Versões mais antigas do Fedora usam uma sintaxe de repositório diferente; consulte o guia atual.

Arch Linux

Instale o OpenRazer e os cabeçalhos correspondentes à sua versão do kernel:

sudo pacman -S openrazer-daemon
sudo pacman -S linux-headers

Use linux-headerspara o kernel padrão do Arch; para outra versão do kernel, instale o pacote de cabeçalho correspondente. O pacote do daemon depende do pacote de drivers OpenRazer. Consulte a lista oficial de pacotes do Arch para obter detalhes sobre os pacotes atuais.

Para Debian, comece com a busca oficial de pacotes ; o suporte a dispositivos mais recentes pode exigir o OpenSUSE Build Service . A página do OBS também abrange o openSUSE. Evite comandos de repositório específicos de versões desatualizados.

2. Defina as permissões e reinicie.

O OpenRazer precisa que sua conta de usuário pertença ao grupo que concede acesso aos arquivos do dispositivo. Na maioria das distribuições, use plugdev:

sudo gpasswd -a $USER plugdev

Em distribuições baseadas em Arch, as orientações atuais de solução de problemas do OpenRazer recomendam o uso do openrazergrupo em vez disso:

sudo gpasswd -a $USER openrazer

Reinicie o sistema após instalar o driver e alterar a associação ao grupo para que o módulo do kernel e as permissões sejam recarregados.

Se o driver não carregar, verifique os cabeçalhos do kernel e a compilação do DKMS. A Inicialização Segura pode bloquear módulos não assinados; consulte o guia de solução de problemas oficial antes de alterar as configurações do firmware.

3. Instale o RazerGenie

O Flatpak funciona em diversas distribuições. Se o Flathub não estiver configurado, adicione o repositório remoto e instale o RazerGenie:

flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install flathub xyz.z3ntu.razergenie

Confirme a instalação quando solicitado. A descrição no Flathub indica que o OpenRazer deve ser instalado fora do Flatpak. O arquivo README do projeto lista as opções de pacote nativo.

4. Configure seu dispositivo Razer

Após reiniciar, abra o RazerGenie no menu de aplicativos e selecione um dispositivo na barra lateral esquerda. Os controles dependem do modelo e da compatibilidade com o OpenRazer.

Alterar efeitos de iluminação e brilho

Em Iluminação , escolha um efeito disponível — como Estático, Respiração, Ciclo de Espectro, Onda ou Reativo — e defina uma cor, se houver. Os efeitos variam conforme o dispositivo.

Use o controle deslizante de brilho para diminuir ou aumentar o brilho da iluminação. Se disponível, abra o Editor de Iluminação Personalizada para atribuir cores a teclas ou zonas; os controles compatíveis variam conforme o modelo.

Ajustar DPI do mouse

Para um mouse compatível, abra as configurações de DPI e edite um nível de sensibilidade. Alguns dispositivos exibem valores X e Y separados ou um controle para vinculá-los. Os valores na ilustração são exemplos; os níveis e o DPI máximo dependem do mouse.

Alterar a taxa de votação

Abra a opção Taxa de Polling e escolha um valor disponível. As opções comuns incluem 125, 250, 500 e 1000 Hz, mas as taxas suportadas variam de acordo com o mouse e podem depender do seu receptor. Não assuma que a taxa mais alta esteja disponível.

5. Se o RazerGenie não detectar seu dispositivo

• Verifique a detecção de USB: execute o comando lsusb | grep 1532e compare o ID do produto com a lista de compatibilidade estável.
• Verifique o daemon: execute systemctl --user status openrazer-daemon.service; se estiver parado, tente systemctl --user restart openrazer-daemon.service.
• Após atualizações do kernel: confirme se os cabeçalhos correspondentes estão instalados e se o DKMS compilou o módulo para o kernel em execução.
• Descarte problemas com a porta USB: reconecte o dispositivo, tente usar uma porta direta em vez de um hub ou switch KVM e abra o RazerGenie novamente.

Assim que o OpenRazer detecta o hardware, o RazerGenie oferece uma maneira gráfica e prática de ajustar a iluminação e os controles do dispositivo compatíveis com o periférico específico.