Meu teclado Keychron funciona no Linux?

Antes de começar

• Os teclados Keychron funcionam no Linux como um teclado USB comum. Para digitar, não precisa instalar nada.
• A Keychron testa oficialmente no Windows, macOS, iOS e Android. No Linux, algumas funções pedem os ajustes deste artigo.
• Os comandos abaixo são digitados no Terminal e pedem a senha de administrador (o sudo).
• Coloque a chave do teclado em Win. O Linux usa a mesma disposição de teclas do Windows.

1. Descubra o tipo do seu teclado

1. Conecte o teclado pelo cabo, com a chave de modo em Cable, se houver.

2. No Terminal, digite:

   lsusb

3. Procure a linha do teclado:

   • ID 3434:… Keychron: o seu teclado é compatível com o Launcher. Siga para o passo 2.
   • ID 05ac:… Apple: é um modelo mais antigo, que se apresenta ao sistema como teclado Apple e não usa o Launcher. Pule para o passo 3.

2. Libere o acesso do Launcher ao teclado

O Linux bloqueia, por segurança, a comunicação direta do navegador com o teclado. O Launcher até mostra o teclado, mas não consegue ler nem gravar as configurações. Uma regra udev libera esse acesso para o seu usuário.

1. No Terminal, crie a regra para os teclados Keychron:

   echo 'KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="3434", MODE="0660", TAG+="uaccess"' | sudo tee /etc/udev/rules.d/99-keychron.rules

2. Recarregue as regras:

   sudo udevadm control --reload-rules && sudo udevadm trigger

3. Desconecte e conecte o cabo do teclado de novo.

4. Abra o Keychron Launcher no Chrome, Chromium, Edge ou Opera e clique em Connect. O Launcher não funciona no Firefox.

A mesma regra libera o acesso do VIA.

O Launcher continua sem conectar? Siga O Launcher não reconhece meu teclado, que confere navegador, cabo e porta.

3. Se F1 a F12 fazem só funções de mídia

Teclado compatível com o Launcher (3434 no passo 1):

• Troque a função das teclas do topo no Launcher. Veja Como remapear as teclas no Keychron Launcher.

Modelo antigo (05ac no passo 1):

1. Com a chave em Win, segure Fn + X + L por 4 segundos. Isso alterna as teclas do topo entre F1 a F12 e funções de mídia.

2. Se não mudar, o driver do Linux para teclados Apple pode estar invertendo as teclas. Teste este comando:

   echo 2 | sudo tee /sys/module/hid_apple/parameters/fnmode

   Ele vale até você reiniciar o computador. Para deixar o ajuste fixo, veja a documentação da sua distribuição sobre o parâmetro fnmode do módulo hid_apple.

A combinação Fn + X + L não vale para todos os modelos. Confira no manual do seu modelo.

4. Problema só na sua distribuição?

Não dá para testar todas as distribuições do Linux. Se o problema acontece só numa distribuição específica, a comunidade de usuários Keychron no Linux pode ajudar: veja como entrar no grupo Keychron Linux.

Antes, teste o teclado no Windows ou no macOS, se puder. Se o problema também acontece lá, a causa não é o Linux: veja Uma tecla parou de funcionar.

Funcionou?

✅ Sim. O Launcher conecta e as teclas respondem como você quer.

❌ Não. Fale com o suporte abaixo. Envie o modelo, a distribuição e a versão do Linux, o navegador e a linha do teclado no resultado do lsusb.