> [!WARNING] > **OpenLogi está em desenvolvimento ativo** e ainda não é estável: recursos e configuração podem mudar. Dê uma estrela ⭐ e acompanhe 👀 o repositório para saber quando um novo lançamento sair.

OpenLogi

⚡️ Uma alternativa nativa e local-first ao Logitech Options+, escrita em Rust 🦀
Libere todo o potencial de mouses, teclados e webcams Logitech via HID++ e UVC

> **Cansado do Options+? Experimente o OpenLogi.** Roda em macOS, Linux e Windows. --- ## Além do Options+ O que o OpenLogi faz e o Options+ não faz: - **Fica leve.** Rust nativo + GPUI. - **Roda em Linux.** Linux é uma plataforma de primeira classe no OpenLogi. - **Gestos nos botões compatíveis.** Atribua ações de gesto aos controles compatíveis, ou desligue os gestos por completo. - **Configuração em texto puro.** Tudo em um único arquivo TOML, sincronizável entre máquinas do jeito que você preferir. - **Programável.** Uma CLI de verdade ao lado da GUI: uma [API de automação](USAGE.md#automation-api) em JSON para DPI, SmartShift, Fn-lock e taxa de relatório, além de diagnósticos de hardware. ## Recursos

Lista de dispositivos do OpenLogi com seis dispositivos Logitech: mouses, um teclado e uma luz Litra

### Dispositivos - Receptores Logi Bolt e Unifying, Bluetooth e conexões com fio, com nível de bateria e estado de carga - Avisos de bateria fraca na parte de baixo da tela, uma vez por descarga, sem precisar de permissão de notificação do sistema - Um indicador na tela quando um teclado liga ou desliga o Caps Lock, além de Num Lock e Scroll Lock no Windows e no Linux

Easy-Switch

Veja qual computador está pareado em cada canal, com o sistema operacional e a conexão
Renomeie um canal nos dispositivos que permitem

### Botões e ações

	Remapeie qualquer botão Um catálogo de ações embutido, atalhos personalizados, texto digitado ou fluxos de várias etapas Ações separadas para toque e pressão longa, e combinações de push-to-talk que soltam junto com o botão Gestos no clique do meio, Voltar/Avançar, DPI/ModeShift, no botão de gesto e no painel háptico
	Actions Ring Oito ações em um anel ao redor do cursor Um layout próprio para cada aplicativo
	Teclas do teclado Vincule teclas de mídia, emoji, captura de tela e outras teclas dedicadas como se fossem botões do mouse Restaure uma tecla ao padrão do dispositivo ou redefina a linha inteira

Os perfis por aplicativo trocam junto com o app em foco. Um alias em `[apps]` permite que um perfil acompanhe um aplicativo em todas as plataformas. ### Ponteiro e rolagem

	Ponteiro Predefinições de DPI com ações de ciclar e definir predefinição Velocidade do ponteiro e taxa de relatório Modo de precisão: um botão leva o mouse à velocidade mais lenta e de volta
	SmartShift Modo da roda e sensibilidade Força de rolagem em mouses com SmartShift Enhanced Uma chave de catraca permanente
Rolagem Inversão de rolagem por dispositivo, nativa ou por software Resolução da roda e rolagem suave da roda Segure Voltar ou Avançar e gire a roda para rolar na horizontal em mouses sem roda lateral

### Teclado e iluminação

	Teclado Fn Lock, e teclados multiplataforma que seguem o layout do sistema operacional do host Nível da luz de fundo, brilho automático e economia de bateria O nível da luz de fundo mostrado na tela enquanto muda RGB estático nos teclados compatíveis
	Luzes Litra Liga/desliga, brilho e temperatura de cor Liga junto com a câmera, se você quiser Mantém um ajuste feito na própria luz

### Webcams - Qualquer webcam UVC da Logitech (Brio, StreamCam, a série C920, …), plug and play - Pré-visualização ao vivo que só ocupa a câmera enquanto você está olhando; saia dela e o LED apaga - Zoom, pan, tilt, foco, exposição, balanço de branco e todos os outros controles UVC, gravados no hardware para que o Meet, o Zoom e o OBS vejam a mudança - Perfis Padrão / Streaming / Chamada de vídeo embutidos mais seus próprios instantâneos, guardados por câmera A cobertura de recursos depende do que cada dispositivo informa; o app mostra só os controles que o dispositivo suporta. ### Suporte por plataforma | Recurso | macOS | Windows | Linux | | --- | --- | --- | --- | | Remapeamento de botões do mouse e gestos | ✓ | ✓ | ✓ | | Remapeamento das teclas F do teclado | ✓ | ✓ | — | | Perfis por aplicativo | ✓ | ✓ | X11, wlroots (sway, Hyprland), GNOME com a [extensão complementar](../crates/openlogi-hook/gnome-shell-extension/README.md) | | Perfil do mouse segue a janela sob o ponteiro | ✓ | ✓ | Só X11 | | Teclas de mídia | Nativo | Nativo | D-Bus MPRIS | | Ações do gerenciador de janelas (áreas de trabalho, Mission Control, …) | Nativo | Equivalentes nativos | GNOME, KDE (KWin), Hyprland; algumas ações exclusivas do macOS não fazem nada | | Ícone na barra de menus / bandeja | ✓ | ✓ | — | | Atualizações no app | Sparkle | Embutido | Embutido | ## Instalação > [!IMPORTANT] > Feche o **Logi Options+** (e o Solaar no Linux) primeiro. Só um aplicativo pode controlar um receptor por vez. | Plataforma | Sistema | Arquitetura | | --- | --- | --- | | macOS | macOS 13 ou mais recente | Apple silicon, Intel | | Linux | GLIBC 2.35 ou mais recente | x86_64, arm64 | | Windows | Testado no Windows 11 | x86_64, arm64 | Todo download traz uma assinatura minisign e uma entrada em `SHA256SUMS`. Para compilar a partir do código-fonte, veja [DEVELOPMENT.md](DEVELOPMENT.md). ### macOS

Ou pelo Homebrew: ```sh brew install --cask openlogi ``` Abra o OpenLogi e conceda **Acessibilidade** e **Monitoramento de entrada** quando o macOS pedir. Depois disso, o OpenLogi se atualiza sozinho pelo Sparkle. ### Linux

Ou instale o pacote certo para a sua distribuição com um único comando. Ele verifica a assinatura minisign e inicia o agente; instale o `minisign` antes: ```sh curl -fsSL https://github.com/AprilNEA/OpenLogi/releases/latest/download/install.sh | sh ``` Para ler o script antes de executá-lo, e para Flatpak, NixOS e distribuições sem systemd, veja [INSTALL-linux.md](INSTALL-linux.md). ### Windows

## Uso (CLI) Veja [USAGE.md](USAGE.md) ## Configuração As configurações usam TOML puro; salvar preserva arquivos de configuração que são links simbólicos. Veja [CONFIGURATION.md](CONFIGURATION.md). ## Desenvolvimento Veja [DEVELOPMENT.md](DEVELOPMENT.md), incluindo [segurança do hook de entrada no macOS](DEVELOPMENT.md#macos-input-hook-safety). ## Agradecimentos - **Windows, câmeras e i18n** por [@davidbudnick](https://github.com/davidbudnick): RGB do teclado, suporte a Windows, suporte às webcams Logitech - **Port para Linux** por [@cserby](https://github.com/cserby): suporte a Linux - [Solaar](https://github.com/pwr-Solaar/Solaar), de [@pwr](https://github.com/pwr): implementação de HID++ de código aberto - [Mouser](https://github.com/TomBadash/Mouser), de [@TomBadash](https://github.com/TomBadash): alternativa local ao Options+, sem conta ## Licença O código deste repositório é licenciado, à sua escolha, sob qualquer uma das seguintes licenças: - Apache License, Version 2.0 ([LICENSE-APACHE](../LICENSE-APACHE)) - Licença MIT ([LICENSE-MIT](../LICENSE-MIT)) ### Código de terceiros `crates/openlogi-hidpp` é um fork vendorizado do [`hidpp`](https://crates.io/crates/hidpp), de [@lus](https://github.com/lus), licenciado sob 0BSD. ### Logo e ativos de marca Obrigado a [@kubai087](https://github.com/kubai087) por desenhar o logo do OpenLogi. O logo e o ícone do app (os ativos de marca em [`design/`](../design/)) são © 2026 AprilNEA, todos os direitos reservados, e não são cobertos pelas licenças MIT/Apache acima; veja [`design/LICENSE`](../design/LICENSE). Fazer fork do código não dá direito ao nome, logo ou ícone do OpenLogi; por favor, não os use para representar seus próprios projetos, forks ou distribuições sem permissão prévia por escrito. --- **Sem vínculo com a Logitech.** "Logitech", "MX Master" e "Options+" são marcas registradas da Logitech International S.A. ## Atividade do repositório ![Repobeats analytics image](https://repobeats.axiom.co/api/embed/4a0b576a03e9d528ad31ccf4797a1286c045d021.svg "Repobeats analytics image")