GPL-3.0-or-later · 0.10.0, beta · Linux, Windows, macOS, navegador
sharkfin
Configurador de código aberto para teclados construídos em hardware ROYUAN: Attack Shark, Akko, Epomaker, MonsGeek, Ajazz, Hator, ikbc e outros. Remapeie teclas em um desenho do teclado, ajuste a iluminação, pinte a cor de cada tecla, grave macros, ajuste os switches em teclados magnéticos e salve as configurações em um arquivo. O registro tem 1409 teclados.
A versão no navegador precisa do Chrome, do Edge ou de outro navegador Chromium. Gravar precisa de um cabo USB. O Linux precisa de uma regra do udev de uma linha, a menos que um pacote já a tenha instalado. Beta: exporte um backup antes de reorganizar as coisas.
Recursos
- Teclas. Clique em uma tecla no desenho do teclado e dê a ela outra tecla, um botão do mouse, movimento do cursor, a roda de rolagem, uma macro ou um controle de mídia. Camadas base e Fn, e o knob. Cada gravação chega ao teclado na hora.
- Iluminação. Os efeitos que o próprio firmware do teclado tem, 18 na maioria dos teclados, com direção, cor, brilho e velocidade. O efeito roda no desenho do teclado enquanto você o altera. Um controle deslizante grava no teclado quando você o solta. Os controles de luz de borda aparecem nos teclados que têm LEDs de borda.
- Pintura. Pinte teclas individuais e envie o padrão para o teclado. O envio é um clique separado e é ritmado, porque o padrão vai para a flash do teclado.
- Macros. Grave sequências de teclas e mouse com atrasos por evento nos 50 slots do teclado, e vincule uma tecla a uma delas em qualquer camada: repetir, alternar ou enquanto pressionada.
- Switches. Em teclados magnéticos: ponto de acionamento, ponto de liberação, rapid trigger, zona morta, dynamic keystroke, mod-tap, alternar e snap, por tecla ou para todas as teclas. A gravação está liberada nos teclados cujo firmware já foi lido, e o Setup pode liberá-la para o seu teclado.
- Dispositivo. Debounce, bloqueio da tecla Windows, troca de WASD e setas, backlight desligado, detecção automática do sistema, tempos de suspensão, redefinição de fábrica e uma imagem para a tela nos teclados que têm uma.
- Backup. Exporte mapas de teclas, iluminação e configurações para um arquivo e restaure depois. As macros e a pintura por tecla não entram no arquivo. Os perfis ficam guardados no próprio teclado.
- Setup. Para um teclado que o sharkfin não conhece: alguns testes e perguntas que o levam de somente leitura a funcionando, com um relatório que pode fazê-lo funcionar para todo mundo. Veja Setup.
Teclados suportados
O sharkfin conversa com teclados construídos em hardware ROYUAN. A maioria informa o vendor ID USB 3151; alguns vêm com o da própria marca.
O teclado é identificado pela própria resposta ao ser conectado, então nunca perguntam qual modelo você tem.
| Teclados no registro | 1409 |
| Graváveis de imediato | 1174 |
| Conjunto de comandos perguntado ao teclado na conexão, gravável depois que você permite | 231 |
| Desenhados tecla por tecla de imediato | 368 |
| Desenhados após uma confirmação única contra o seu teclado | 833 |
Um teclado sem desenho funciona mesmo assim: você vê uma grade de slots de teclas, ou pode desenhar o teclado na aba Teclas. Um teclado que não está na lista é lido pelas próprias respostas, e a página Setup libera as alterações e as verifica uma a uma. O que "suportado" quer dizer, estado por estado: Suporte.
Segurança e privacidade
- O sharkfin grava configurações, nunca firmware. Não há nada para brickar. Se o teclado parar de responder, desconecte por dez segundos. Segurança
- Nenhuma gravação vai para um teclado cujo conjunto de comandos é desconhecido. O próprio teclado diz qual ele fala.
- A versão no navegador não faz requisições próprias depois de carregada e recebe o canal de configurações do teclado, nunca a digitação. Sem conta, sem analytics, sem cookies. Privacidade
Perguntas
Meu teclado é suportado?
Conecte e o sharkfin diz o que vê. A lista de teclados tem uma página por modelo com os ids USB e o que o sharkfin consegue fazer nele. Um teclado que não está na lista é lido pelas próprias respostas e configurado na página Setup.
Uso Linux. Preciso de uma regra do udev?
Os pacotes .deb, .rpm e Arch instalam a regra. Para o AppImage ou a versão no navegador, cole isto em um terminal e reconecte o teclado:
echo 'SUBSYSTEM=="hidraw", ATTRS{idVendor}=="3151|0461|046a|0db0|145f|14a5|2ea8|3121|3299|331a|374a|379a|38a9|38ee|391d|3984|39a8|39ab|54ab", MODE="0660", TAG+="uaccess"' \
| sudo tee /etc/udev/rules.d/70-sharkfin.rules >/dev/null \
&& sudo udevadm control --reload-rules && sudo udevadm trigger Regras do VIA, do Vial ou de um pacote de fabricante podem já bastar. O sharkfin mostra o mesmo comando quando encontra um teclado que não consegue abrir. Mais em Linux.
Preciso de um cabo?
Para gravar, sim. Por um receptor de 2.4 GHz o sharkfin lê o que o receptor repassa: alguns levam o canal de configurações, outros não levam nada, e o mesmo modelo vem com os dois, então não há resposta por teclado. Conecte o receptor e o app diz qual é o seu. O Bluetooth não tem canal de configurações. As configurações ficam guardadas no teclado, então continuam funcionando sem fio depois.
Ele pode brickar meu teclado?
Ele nunca grava firmware. A pior falha conhecida é o teclado ignorar o USB até você reconectá-lo: feche o app, desconecte por dez segundos, conecte de novo. A digitação continua funcionando o tempo todo.