OpenLogi README

The project's README from github.com/AprilNEA/OpenLogi. As one markdown file: README.md.

[!WARNING] OpenLogi is under active development and not yet stable — features and config may still change. Give the repo a Star ⭐ and Watch 👀 it to get notified when a new release lands.

English | 简体中文 | 日本語 | Deutsch | Français | 한국어 | Русский

OpenLogi

OpenLogi

⚡️ A native, local-first alternative to Logitech Options+, written in Rust 🦀
Unlock the full capabilities of Logitech mice, keyboards, and webcams over HID++ and UVC

twitter telegram GitHub downloads GitHub commit Hits

AprilNEA%2FOpenLogi | Trendshift OpenLogi - A local-first alternative to Logitech Options+ | Product Hunt

Fed up with Options+? Try OpenLogi.

Runs on macOS, Linux, and Windows.

Beyond Options+

Things OpenLogi does that Options+ won't:

Features

Mouse

Keyboard

Camera

¹ Media key actions use D-Bus MPRIS on Linux; a handful of macOS-specific actions have no universal Linux equivalent and are no-ops. Windows maps platform actions to native equivalents where available.

Install

[!IMPORTANT] Quit Logi Options+ first: the two applications fight over HID++ access, and only one can own a given receiver at a time.

macOS

Requires macOS 13 or later.

Download the signed, notarized .dmg from the latest release and drag OpenLogi.app to /Applications.

Or install via Homebrew:

brew install --cask openlogi

The official Homebrew cask is the default installation path. To explicitly track the latest GitHub release from aprilnea/tap instead:

brew tap aprilnea/tap
brew install --cask aprilnea/tap/openlogi@latest

openlogi@latest is maintained by OpenLogi's release workflow and may update before the official cask autobump lands. Install either openlogi or openlogi@latest, not both.

Linux

Download the package for your distribution from the latest release:

# Debian / Ubuntu
sudo dpkg -i openlogi-*.deb

# Fedora / RHEL
sudo rpm -i openlogi-*.rpm

# Arch Linux
sudo pacman -U openlogi-*.pkg.tar.zst

Packages are published for both x86_64/amd64 and arm64/aarch64. Pre-built packages require GLIBC 2.35 or newer (Ubuntu 22.04 baseline).

NixOS users can instead import the repository's module, which installs the package and udev rules and starts the agent with the graphical session:

{
  inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
  inputs.openlogi = {
    url = "github:AprilNEA/OpenLogi";
    inputs.nixpkgs.follows = "nixpkgs";
  };

  outputs = { nixpkgs, openlogi, ... }: {
    nixosConfigurations.my-host = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux"; # or aarch64-linux
      modules = [
        openlogi.nixosModules.default
        { programs.openlogi.enable = true; }
      ];
    };
  };
}

All Linux packages install udev rules that grant your user access to /dev/hidraw*, /dev/uinput and your Logitech mouse's /dev/input/event* node without sudo. The NixOS module starts the agent automatically; after a .deb, .rpm, or .pkg.tar.zst installation, enable it for your user:

systemctl --user enable --now openlogi-agent.service

See docs/INSTALL-linux.md for complete NixOS options, manual / source installs, and distros without systemd.

Windows

Signed portable .zip archives and per-user .msi installers (x86_64 and arm64) are attached to each release. Both ship the GUI (OpenLogi.exe) together with the background agent (openlogi-agent.exe), which owns all device I/O. Keep the two files side by side when using the portable zip, or the GUI has nothing to connect to.

Windows support has been validated end-to-end on Windows 11 with real hardware (a wired keyboard and a Unifying-receiver mouse), including install, in-place upgrade, and uninstall of the MSI. It is newer than the macOS build, so if you hit a rough edge please report it. The agent shows a system-tray icon (Show Main Window / Quit) so the app stays reachable after the main window is closed. To disable it on Windows, set show_in_menu_bar = false in the TOML [app_settings] block and restart the agent; the GUI toggle is currently macOS-only.

To build from source, see DEVELOPMENT.md.

Usage (CLI)

See USAGE.md

Configuration

See CONFIGURATION.md

Developing

See DEVELOPMENT.md

Acknowledgments

License

The code in this repository is dual-licensed under either of

at your option.

Third-party code

crates/openlogi-hidpp is a vendored fork of hidpp by @lus, licensed 0BSD.

Logo & brand assets

Thanks to @kubai087 for designing the OpenLogi logo. The OpenLogi logo and app icon (the brand assets under design/) are © 2026 AprilNEA, all rights reserved, and are not covered by the MIT/Apache licenses above; see design/LICENSE. Forking the code grants no right to the OpenLogi name, logo, or icon; please don't use them to represent your own projects, forks, or distributions without prior written permission.

Not affiliated with Logitech. "Logitech", "MX Master", and "Options+" are trademarks of Logitech International S.A.

Repo activity

Repobeats analytics image

OpenLogi (AprilNEA/OpenLogi)

Searching Database…

23.8K ·GitHub
OpenLogi
这是什么?OpenLogi 是一个用 Rust 编写的原生、本地优先的 Logitech Options+ 替代品:它通过 HID++ 和 UVC 解锁罗技的鼠标、键盘和摄像头功能,无需账号,也没有遥测。
它和直接用 Logitech Options+ 有什么不一样?它更轻量(原生 Rust + GPUI),把 Linux 当作一等公民平台来对待,可以把手势放到任意按键上,所有设置都保存在一个纯文本 TOML 文件里,并且在图形界面之外还提供一个真正的命令行工具。
我可以把它和 Logitech Options+ 一起装着用吗?不行——请先退出 Options+:两个程序会争抢 HID++ 的访问权限,同一个接收器同一时间只能由一个程序占用。设备可以通过 Logi Bolt、Unifying 接收器、蓝牙或有线方式连接。
它现在稳定到可以完全替代 Options+ 了吗?还差一点——它仍在积极开发中,还不稳定,功能和配置都可能变化。Windows 是最新的移植版本,已在 Windows 11 上做过端到端验证,但粗糙的地方在所难免。
它能在 Linux 上用吗,还是像官方软件那样只支持 macOS?它可以在 macOS 13+、Linux 和 Windows 上原生运行。Linux 是一等公民:提供 x86_64 和 arm64 软件包(需要 GLIBC 2.35+)、NixOS 模块,以及 udev 规则,无需 sudo 就能访问 /dev/hidraw 和 /dev/uinput。
它需要账号吗?会把数据发送到别处吗?不需要账号,也没有遥测——它是本地优先的。所有设置都保存在一个 TOML 文件里,由你自己在一台台电脑之间同步。
对 MX Master 这一级别的鼠标,它能做什么?支持 DPI 预设以及 Cycle 和 Set 动作,完整的 SmartShift 控制(模式、灵敏度,以及一个永久棘轮模式的面板),可重新映射中键、模式切换键和滚轮横向按钮,支持每个方向的带实时录制的手势,还有 Actions Ring——一个以光标为中心、带八个槽位的动作浮层。
键盘和摄像头它也能管吗?能:支持全局 F 键重映射(可输入文字、组合键和多步骤工作流)(macOS + Windows),以及静态 RGB 灯效。任何罗技 UVC 摄像头(Brio、StreamCam、C920 系列)都是即插即用——图像设置会直接写入摄像头硬件,所以在 Zoom、Meet、OBS 以及所有其他软件里都生效。
按应用程序区分的配置文件是怎么工作的?当某个应用获得焦点时,配置文件叠加层会自动切换——在 macOS 和 Windows 上都支持,在 Linux 上仅限 X11 或 XWayland 环境。媒体键动作在 Linux 上通过 D-Bus MPRIS 实现,其中少数 macOS 专有动作在那里不起作用。
不打 开图形界面,我能用脚本操作它吗?可以——图形界面之外还附带一个真正的命令行工具(文档见 USAGE.md),而且整个配置就是一个 TOML 文件,你可以手动编辑和同步。
What are similar projects?Mouser, juhradial-mx, gyotaku, Meltype, lightcraft, rawaccel, TrafficMonitor, HaloBattery
Which topics is it in?dpi, gpui, camera, configuration, hardware, windows-app, customization, utility, local-first, desktop, rust, gui
Creator
AprilNEA
Size
17.8 MB
Stars
23.8K
Updated
CommitOct 18Releasev0.8.14Oct 15
Age
4mo
Commits · 90 Days