OpenLogi: configure seu mouse Logitech localmente com Rust

O que é OpenLogi

O OpenLogi é um aplicativo nativo e local para configurar periféricos Logitech. Ele oferece uma alternativa independente ao Logitech Options+, com código escrito em Rust e sem exigir uma conta para funcionar.

A proposta é conversar diretamente com dispositivos compatíveis por meio do protocolo HID++. Assim, o usuário pode remapear botões, ajustar DPI, controlar o SmartShift e manter as configurações em um arquivo TOML na própria máquina.

O projeto ganhou atenção por juntar três ideias que interessam a muitos desenvolvedores: binários nativos, operação local e suporte a macOS, Linux e Windows. Ele é mantido como projeto open source independente da Logitech e ainda está em desenvolvimento ativo, portanto recursos e configurações podem mudar.

Como funciona

O OpenLogi usa o HID++ para enviar comandos ao periférico por receptor Logi Bolt, Unifying ou Lightspeed, por Bluetooth direto ou por cabo USB. O aplicativo não precisa depender de um serviço remoto para aplicar as mudanças básicas.

A arquitetura é dividida em componentes. A interface gráfica mostra o dispositivo e os controles, enquanto um agente em segundo plano cuida do acesso ao hardware e do hook de entrada. Também existe uma interface de linha de comando para inventário e diagnósticos.

As associações de botões ficam em um arquivo TOML legível. Isso permite abrir a configuração em um editor, comparar mudanças no Git ou copiar o arquivo para outra máquina, desde que o dispositivo e os identificadores usados sejam compatíveis.

Uma boa analogia é pensar no OpenLogi como uma camada de controle entre o sistema operacional e o mouse. A interface ajuda a escolher uma ação, o agente conversa com o periférico e o arquivo TOML registra como aquela escolha deve ser aplicada.

Principais recursos

O recurso central é o remapeamento de botões. O usuário escolhe um botão no diagrama do mouse e associa uma ação pronta, um atalho personalizado, um lançador de aplicativo ou uma ação criada para um fluxo específico.

Também é possível ajustar DPI e criar predefinições, controlar o SmartShift e configurar comportamentos da rolagem. Em modelos compatíveis, o aplicativo conversa com os recursos do dispositivo por HID++ em vez de limitar-se a atalhos genéricos do sistema.

O projeto ainda oferece uma interface de linha de comando para inventário, sincronização de recursos, controle de iluminação e diagnósticos. Perfis por aplicativo aparecem como uma área em evolução, então vale conferir a documentação da versão instalada antes de depender dela.

• 44 ações integradas: atalhos, lançadores e funções comuns para os botões.
• DPI e SmartShift: ajustes do sensor e do comportamento da roda.
• Configuração em TOML: arquivo simples, legível e fácil de versionar.
• Conexões variadas: receptor, Bluetooth direto ou USB.
• Operação local: sem conta obrigatória e sem telemetria de uso.

Como começar: instalação ou acesso passo a passo

Comece abrindo o site oficial e escolhendo o instalador da sua plataforma. O projeto oferece pacotes para macOS, Linux e Windows. No Windows, o instalador é uma versão mais nova e foi validado pelo projeto em hardware com Windows 11, mas pode ter mais arestas que as versões de macOS e Linux.

No macOS, o caminho documentado inclui o Homebrew. No Linux, há pacotes nos formatos DEB, RPM e Arch. No Windows, baixe o instalador MSI assinado no site oficial. Em qualquer plataforma, confira as instruções de conexão da documentação para saber se o seu receptor ou dispositivo é compatível.

brew install --cask openlogi

Antes do primeiro teste, feche o Logitech Options+ e o agente dele na bandeja do sistema. Os dois aplicativos podem disputar o acesso HID++ ao mesmo receptor, e apenas um deles consegue controlar o dispositivo por vez.

Exemplo prático

Imagine uma pessoa que usa um MX Master para programar. Ela quer transformar o botão lateral em voltar no navegador, usar o outro botão para avançar, alternar uma predefinição de DPI e deixar a roda com SmartShift.

O primeiro passo é instalar e abrir o OpenLogi, conectar o mouse por receptor ou Bluetooth e selecionar o dispositivo na interface. Depois, a pessoa clica em cada botão no diagrama, escolhe a ação correspondente e salva a configuração.

O resultado fica registrado no arquivo TOML local. Se a pessoa quiser auditar a alteração, pode abrir o arquivo e encontrar a associação do dispositivo e dos botões. O teste deve ser feito em um aplicativo comum e também no editor de código, para confirmar que os atalhos não criaram conflitos.

schema_version = 2

Esse trecho é apenas um modelo de leitura da estrutura, não uma configuração universal. Os nomes dos dispositivos, dos botões e das ações dependem do hardware detectado e da versão do OpenLogi instalada.

Comparação com alternativas

O Logitech Options+ é a alternativa oficial para quem usa macOS ou Windows e quer uma interface integrada ao ecossistema da fabricante. Ele pode ser a escolha mais previsível quando o modelo do periférico é novo, quando o suporte oficial é prioridade ou quando recursos proprietários são indispensáveis.

No Linux, o Solaar é uma alternativa conhecida para administrar periféricos Logitech. Ele tem uma história mais longa nesse sistema, enquanto o OpenLogi aposta em uma interface nativa em Rust, uma configuração em texto e uma experiência que também contempla macOS e Windows.

Há ainda as configurações nativas do sistema operacional e ferramentas específicas de atalho. Elas resolvem casos simples, mas normalmente não expõem DPI, SmartShift e outros recursos HID++ com a mesma profundidade.

O ponto forte do OpenLogi é combinar controle local, binário nativo e configuração editável em uma única ferramenta. A escolha depende do seu modelo, do sistema usado e do quanto você valoriza independência de conta e serviços em segundo plano.

Pontos positivos e limitações

O maior ponto positivo é a privacidade operacional. As associações ficam na máquina e o projeto informa que não exige conta nem envia telemetria. Para quem prefere ferramentas locais, isso reduz dependências e deixa mais claro onde a configuração está armazenada.

Outro benefício é o formato nativo. Um aplicativo em Rust pode ser mais enxuto que uma suite baseada em Electron, e o suporte a Linux amplia o público em relação ao Options+. A combinação é especialmente interessante para quem gosta de inspecionar e versionar arquivos de configuração.

A limitação principal é a maturidade. O OpenLogi está em desenvolvimento ativo e ainda não é estável. O suporte pode variar entre modelos e sistemas, e o Windows é a porta mais nova. Recursos em evolução, como perfis por aplicativo, não devem ser tratados como garantia para uma operação crítica.

Casos de uso reais

Para desenvolvedores Linux, o OpenLogi pode resolver uma dor antiga: controlar um mouse Logitech sem instalar um aplicativo oficial que não oferece suporte completo à plataforma. O foco local também combina com máquinas de trabalho nas quais o usuário prefere reduzir serviços residentes.

Para quem alterna entre programação e edição de conteúdo, os botões extras podem abrir ferramentas, navegar entre abas ou acionar atalhos repetitivos. O ganho não está em uma função mágica, mas em reduzir movimentos que se repetem centenas de vezes durante o dia.

Para equipes técnicas, o arquivo TOML pode servir como documentação da configuração de uma estação. Antes de distribuir o arquivo, é necessário revisar identificadores e ações para não copiar uma associação feita para um modelo diferente.

Para usuários preocupados com privacidade, a ferramenta é uma candidata a teste quando a necessidade é controlar o hardware sem criar uma conta em um serviço. Mesmo assim, é importante confirmar o comportamento da versão instalada e ler as informações de rede da documentação.

Dicas e boas práticas

Faça um inventário do hardware antes de personalizar tudo. Anote o modelo do mouse, o tipo de conexão e quais funções já funcionam. Isso facilita descobrir se uma falha vem do dispositivo, do receptor ou da configuração.

Use nomes de ações que façam sentido no seu fluxo e guarde uma cópia do TOML antes de atualizar o aplicativo. Se você versionar o arquivo, não inclua informações que não deveriam sair da máquina.

O erro mais comum é esquecer que o Options+ ou o Solaar ainda está aberto. Outro é atribuir o mesmo atalho usado pelo editor, pelo terminal e pelo sistema. Teste o botão nos aplicativos que você realmente usa.

Vale a pena?

Vale a pena testar o OpenLogi se você usa Linux, quer uma alternativa local ao Options+ ou gosta de manter configurações em arquivos legíveis. A proposta é clara e conversa bem com quem prefere software nativo, open source e sem conta obrigatória.

Talvez não seja a melhor escolha para quem precisa de suporte oficial imediato, usa um periférico ainda não coberto ou depende de um recurso proprietário específico. Nesse cenário, a ferramenta oficial ou uma alternativa madura pode oferecer menos surpresas.

O próximo passo é abrir a documentação, verificar a lista do seu dispositivo e fazer uma instalação de teste. Remapeie um botão, confira o DPI, feche o aplicativo e abra de novo. Se tudo se mantiver funcionando, você já terá uma medida concreta do valor da ferramenta no seu fluxo.