Mouser: Alternativa de código aberto ao Logitech Options+ para MX Master 3S

O que o Mouser faz

Mouser é uma alternativa leve e de código aberto ao Logitech Options+ para remapear todos os botões programáveis do mouse Logitech MX Master 3S. Ele é executado totalmente localmente sem telemetria, sem serviços em nuvem e sem necessidade de conta Logitech.

Principais recursos

• Suporte a macOS — compatibilidade total usando CGEventTap para captura do mouse, Quartz CGEvent para simulação de teclas e NSWorkspace para detecção de aplicativos
• Remapeia todos os 6 botões programáveis — clique do meio, botão de gestos, voltar, avançar, rolagem horizontal esquerda/direita
• Perfis por aplicativo — alterna automaticamente os mapeamentos dos botões quando você troca de aplicativo (ex: configurações diferentes para Chrome vs. VS Code)
• 22 ações integradas nas categorias de navegação, navegador, edição e mídia
• Controle de DPI/velocidade do ponteiro — controle deslizante de 200–8000 DPI com predefinições rápidas, sincronizado ao dispositivo via HID++
• Inversão da direção de rolagem — alternadores independentes para rolagem vertical e horizontal
• Suporte ao botão de gestos — desvio completo HID++ 2.0 via Bluetooth (sem necessidade de software Logitech)
• Monitor de bateria — lê o nível da bateria via HID++ na conexão e atualiza a cada 5 minutos; exibido como um ícone codificado por cores (verde acima de 70%, amarelo 20–69%, vermelho abaixo de 20%)
• Reconexão automática — detecta automaticamente quando o mouse é desligado/ligado ou desconectado/reconectado
• Status de conexão em tempo real — a interface mostra o ícone "Conectado" / "Não Conectado" em tempo real
• Interface moderna Qt Quick — tema Material escuro com diagrama interativo do mouse e seletor de ação por botão
• Bandeja do sistema — executa em segundo plano, minimiza para a bandeja ao fechar
• Detecção automática do aplicativo em primeiro plano — verifica a janela ativa e alterna perfis instantaneamente
• Zero serviços externos — a configuração é um arquivo JSON local, todo o processamento acontece na sua máquina

Dispositivo suportado

Dispositivo: Logitech MX Master 3S
ID do produto: 0xB034
Protocolo: HID++ 4.5 (Bluetooth)
Conexão: Bluetooth (o receptor USB também funciona para botões básicos)

A arquitetura foi projetada para ser extensível a outros mouses Logitech HID++, mas apenas o MX Master 3S foi testado.

Mapeamentos padrão

• Botão voltar: Alt + Tab (Alternar Janelas)
• Botão avançar: Alt + Tab (Alternar Janelas)
• Clique do meio: Pass-through
• Botão de gestos: Pass-through
• Rolagem horizontal esquerda: Voltar no navegador
• Rolagem horizontal direita: Avançar no navegador

Ações disponíveis

• Navegação: Alt+Tab, Alt+Shift+Tab, Mostrar Área de Trabalho (Win+D), Visualização de Tarefas (Win+Tab)
• Navegador: Voltar, Avançar, Fechar Aba (Ctrl+W), Nova Aba (Ctrl+T)
• Edição: Copiar, Colar, Recortar, Desfazer, Selecionar Tudo, Salvar, Localizar
• Mídia: Aumentar Volume, Diminuir Volume, Silenciar Volume, Reproduzir/Pausar, Próxima Faixa, Faixa Anterior
• Outros: Não Fazer Nada (pass-through)

Baixar e executar

Não requer instalação. Basta baixar, extrair e clicar duas vezes.

1. Baixe Mouser.zip (45 MB)
2. Extraia o zip para qualquer pasta (Área de Trabalho, Documentos, onde preferir)
3. Execute Mouser.exe

O aplicativo será aberto e começará a remapear os botões do seu mouse imediatamente. A janela de configurações abre mostrando o diagrama do seu mouse, e um ícone aparece na bandeja do sistema perto do relógio. O remapeamento dos botões fica ativo imediatamente. Fechar a janela não encerra o aplicativo — ele continua executando na bandeja. Para encerrar completamente: clique com o botão direito no ícone da bandeja → Sair do Mouser.

Notas para primeira execução

• O Windows SmartScreen pode mostrar um aviso na primeira vez → clique em Mais informações → Executar mesmo assim
• O Logitech Options+ não deve estar em execução (conflita com o acesso HID++)
• A configuração é salva automaticamente em %APPDATA%\Mouser

Instalação a partir do código-fonte

Pré-requisitos:

• Windows 10/11 ou macOS 12+ (Monterey)
• Python 3.10+ (testado com 3.14)
• Logitech MX Master 3S emparelhado via Bluetooth ou receptor USB