English | 简体中文 | 日本語 | Deutsch | Français | 한국어

OpenLogi

⚡️ 一个原生、本地优先的罗技 Options+ 替代方案，使用 Rust 🦀 编写
通过 HID++ 和 UVC 全面解锁罗技鼠标、键盘和摄像头的完整功能

受够了 Options+？来试试 OpenLogi。

支持 macOS、Linux 和 Windows。

---

超越 Options+

OpenLogi 可以，而 Options+ 做不到：

• 保持轻量。 原生 Rust + GPUI。
• 在 Linux 上运行。 在 OpenLogi 中，Linux 是一等公民平台。
• 任意物理按键手势。 可将手势角色赋予任意物理按键——或完全关闭手势。
• 纯文本配置。 所有内容都由一个 TOML 文件承载，可按任意方式在多台机器间同步。
• 可脚本化。 GUI 之外，还有真正的 CLI。

功能

• 支持通过 Logi Bolt 接收器、Unifying 接收器、蓝牙或有线连接接入的设备，并显示电池百分比与充电状态
• 通过系统输入钩子实现按键重映射：内置动作目录，外加在 TOML 配置中编写的自定义键盘快捷键；支持独立的短按/长按动作，以及用于按下说话的按住至释放组合键¹
• 按应用配置叠加层，在应用获得焦点时自动切换（macOS + Windows；Linux 仅支持 X11 / XWayland）
• Litra 灯光：电源、亮度与色温，支持可选的自动开关，并跟随摄像头活动

鼠标

• 捕获并重映射中键、模式切换键与拇指滚轮键（中键普遍可用，其余按键仅在设备支持时可用）
• 支持按方向绑定手势，可在任意支持手势的按键上实时捕获
• Actions Ring：以光标为中心的八格动作叠加层（ShowActionsRing），支持按应用设置布局
• DPI 控制：支持预设以及 Cycle / Set-preset 动作（0x2201）
• SmartShift 滚轮：模式切换、灵敏度与永久棘轮面板（0x2111）
• 按设备设置原生滚动方向反转（0x2121，适用于支持的设备）

键盘

• 全局 F 键重映射：与鼠标相同的动作目录，外加高级用户动作——键入文本、组合键、多步工作流（macOS + Windows）
• 静态 RGB 灯光（0x8070 / 0x8080，适用于支持的设备）

摄像头

• 任意 Logitech UVC 摄像头（Brio、StreamCam、C920 系列……），即插即用
• 实时预览仅在你查看时打开摄像头——离开后会完全释放摄像头，LED 熄灭
• 图像控制直接写入 UVC 硬件——变焦、对焦、曝光、亮度、对比度、饱和度、锐度、白平衡、色调、防闪烁与低光补偿，并支持对焦 / 曝光 / 白平衡的自动模式切换——因此更改会在 Meet / Zoom / OBS 以及所有使用摄像头的应用中生效
• 一键配置：内置 Default / Streaming / Video call 以及自定义快照；设置按摄像头持久保存，并在下次查看时写回硬件

¹ 媒体键动作在 Linux 上使用 D-Bus MPRIS；少量 macOS 专属动作没有通用的 Linux 等效实现，因此不会执行。Windows 会在可用时将平台动作映射到原生等效动作。

安装

macOS

需要 macOS 13 或更高版本。

从最新版本下载已签名并完成公证的 .dmg 文件，然后将 OpenLogi.app 拖到 /Applications。

或者通过 Homebrew 安装：

brew install --cask openlogi

官方 Homebrew cask 是默认安装路径。若要显式 跟踪来自 aprilnea/tap 的最新 GitHub release：

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

openlogi@latest 由 OpenLogi 的发布工作流维护，可能早于官方 cask 自动版本更新合并。请安装 openlogi 或 openlogi@latest 其中之一，不要同时安装。

Linux

从最新版本下载适用于你发行版的软件包：

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

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

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

x86_64/amd64 与 arm64/aarch64 均已发布软件包。 预构建软件包需要 GLIBC 2.35 或更高版本（Ubuntu 22.04 基线）。

NixOS 用户也可以导入仓库中的模块，该模块会安装软件包和 udev 规则，并随图形会话启动服务进程：

{
  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; }
      ];
    };
  };
}

所有 Linux 软件包都会安装 udev 规则，在无需 sudo 的情况下，授予当前用户对 /dev/hidraw*、/dev/uinput 以及你的 Logitech 鼠标的 /dev/input/event* 设备节点的访问权限。NixOS 模块会自动启动 agent；安装 .deb、.rpm 或 .pkg.tar.zst 包后，请为当前用户启用它：

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

完整的 NixOS 选项、手动 / 源码安装方式，以及没有 systemd 的发行版，请参见 docs/INSTALL-linux.md。

Windows

每个发布版本都会附带已签名的可移植 .zip 压缩包，以及按用户安装的 .msi 安装程序（支持 x86_64 和 arm64）。二者均包含图形界面（OpenLogi.exe）和后台代理（openlogi-agent.exe），后者负责所有设备 I/O。使用可移植压缩包时，请将这两个文件放在同一目录下，否则图形界面将没有可连接的对象。

Windows 支持已在 Windows 11 上通过真实硬件（有线键盘和使用 Unifying 接收器的鼠标）完成端到端验证，涵盖 MSI 的安装、就地升级和卸载。Windows 构建比 macOS 构建更新，因此如遇到任何不完善之处，请报告该问题。代理会在系统托盘中显示一个图标（显示主窗口 / 退出），以便在主窗口关闭后仍能访问应用。若要在 Windows 上禁用该托盘图标，请在 TOML 的 [app_settings] 配置块中设置 show_in_menu_bar = false，然后重新启动代理；图形界面中的切换开关目前仅限 macOS。

如要从源码构建，请参见 DEVELOPMENT.md。

使用（CLI）

参见 USAGE.md

配置

参见 CONFIGURATION.md

开发

参见 DEVELOPMENT.md

致谢

• Windows、摄像头和 i18n 由 @davidbudnick 贡献 — 键盘 RGB、Windows 支持、Logitech 网络摄像头支持
• Linux 移植 由 @cserby 贡献 — Linux 支持
• Solaar 由 @pwr 开发 — 开源 HID++ 实现
• Mouser 由 @TomBadash 开发 — 一款本地、无需账号的 Options+ 替代方案

许可证

本仓库中的代码采用双重许可授权，您可任选以下任一许可证作为适用许可证：

• Apache License, Version 2.0 (LICENSE-APACHE)
• MIT license (LICENSE-MIT)

第三方代码

crates/openlogi-hidpp 是 hidpp 的内置 fork，由 @lus 提供，采用 0BSD 许可。

标志与品牌资产

感谢 @kubai087 设计了 OpenLogi 标志。OpenLogi 标志和应用图标（design/ 目录下的品牌资产）© 2026 AprilNEA，保留所有权利，且不在上述 MIT/Apache 许可证的覆盖范围内；详见 design/LICENSE。Fork 代码并不会授予对 OpenLogi 名称、标志或图标的任何权利；未经事先书面许可，请勿使用它们来代表 你自己的项目、fork 或发行版。

---

与 Logitech 无隶属关系。 “Logitech”、“MX Master” 和 “Options+” 均为 Logitech International S.A. 的商标。

仓库动态