OpenLogi：用 Rust 编写的 Logitech Options+ 替代方案，多系统支持且功能强大！-开发者社区

警告

OpenLogi 正在积极开发中，尚未稳定，其功能和配置可能仍会发生变化。给该仓库点个星 ⭐ 并关注 👀 它，以便在新版本发布时收到通知。

OpenLogi ⚡️

一款用 Rust 🦀 编写的原生、本地优先的 Logitech Options+ 替代方案。通过 HID++ 和 UVC 协议，充分发挥罗技鼠标、键盘和网络摄像头的全部功能。如果你受够了 Options+，不妨试试 OpenLogi。它可在 macOS、Linux 和 Windows 系统上运行。

超越 Options+

轻量级运行：采用原生 Rust 语言并结合 GPU 加速。
支持 Linux：在 OpenLogi 中，Linux 是一等公民平台。
任意按键设置手势：可以为任意物理按键设置手势功能，也可完全关闭手势功能。
纯文本配置：所有配置都存储在一个 TOML 文件中，你可以按照自己的方式在不同设备间同步。
支持脚本操作：除了图形界面，还提供了真正可用的命令行界面（CLI）。

功能特性

设备支持

支持通过 Logi Bolt 接收器、Unifying 接收器、蓝牙或有线连接的设备，可显示电池百分比和充电状态。

按键重映射

通过操作系统输入钩子实现按键重映射，内置操作目录，还可在 TOML 配置文件中自定义快捷键¹。

应用程序配置文件覆盖

支持按应用程序自动切换配置文件（macOS 和 Windows 系统支持；Linux 系统仅在 X11 / XWayland 环境下支持）。

Litra 灯光控制

可控制 Litra 灯的电源、亮度和色温，还能选择跟随摄像头活动自动开关电源。

鼠标按键功能

可捕获并重新映射鼠标中间键、模式切换键和拇指滚轮键（中间键在所有设备上可用，其他键在支持的设备上可用），能在任意支持的按键上进行按方向的手势绑定，支持实时捕获。

动作环（Actions Ring）

以光标为中心的八槽动作覆盖层（ShowActionsRing），支持按应用程序设置布局。

DPI 控制

支持预设 DPI 值，可通过 Cycle / Set - preset 操作切换（指令码 0x2201）。

智能滚轮（SmartShift wheel）

可切换模式、调整灵敏度，还能设置永久棘轮模式（指令码 0x2111）。

设备原生滚动反转

支持部分设备按设备进行原生滚动方向反转（指令码 0x2121）。

键盘功能

全局 F 键重映射：与鼠标操作目录相同，还支持高级用户操作，如输入文本、组合按键、多步骤工作流程（macOS 和 Windows 系统支持）。
静态 RGB 灯光控制：支持部分设备（指令码 0x8070 / 0x8080）。

摄像头功能

支持任意罗技 UVC 网络摄像头（如 Brio、StreamCam、C920 系列等），即插即用。
实时预览功能，仅在查看时开启摄像头，关闭预览则完全释放摄像头，指示灯熄灭。
直接对 UVC 硬件进行图像控制，包括缩放、对焦、曝光、亮度、对比度、饱和度、锐度、白平衡、色调等，支持对焦/曝光/白平衡自动模式切换，设置更改可在 Meet / Zoom / OBS 等所有使用该摄像头的应用中生效。
一键切换配置文件，内置默认、直播、视频通话等配置文件，还支持自定义快照；设置会按摄像头保存，并在下一次查看时写回硬件。

¹ 媒体键操作在 Linux 系统上使用 D - Bus MPRIS 协议；少数 macOS 特定操作在 Linux 上没有通用等效操作，会被忽略。Windows 系统会在可用情况下将平台操作映射为本地等效操作。

安装说明

重要提示

请先退出 Logi Options+，因为这两个应用会争夺 HID++ 访问权限，同一时间只能有一个应用控制特定的接收器。

macOS

需要 macOS 13 或更高版本。从最新版本中下载已签名并经过公证的 .dmg 文件，将 OpenLogi.app 拖到 /Applications 文件夹。
也可通过 Homebrew 安装：`brew install --cask openlogi`，官方 Homebrew cask 是默认安装路径。若要明确跟踪 aprilnea/tap 中的最新 GitHub 版本：

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 架构版本。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"; # 或 aarch64-linux
modules = [
openlogi.nixosModules.default {
programs.openlogi.enable = true;
}
];
};
};
}

所有 Linux 软件包都会安装 udev 规则，允许用户在不使用 sudo 的情况下访问 `/dev/hidraw*`、`/dev/uinput` 和罗技鼠标的 `/dev/input/event*` 节点。NixOS 模块会自动启动代理；在安装 .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），后台代理负责所有设备的输入输出操作。使用便携式 zip 文件时，请将这两个文件放在同一目录下，否则图形界面将无法连接到代理。Windows 支持已在 Windows 11 系统上使用真实硬件（有线键盘和 Unifying 接收器鼠标）进行了端到端验证，包括 MSI 安装包的安装、就地升级和卸载。该版本比 macOS 版本更新，如果你遇到问题，请及时反馈。代理会在系统托盘显示图标（显示主窗口/退出），以便在主窗口关闭后仍可访问应用。若要在 Windows 系统上禁用该图标，可在 TOML 文件的 `[app_settings]` 块中设置 `show_in_menu_bar = false` 并重启代理；目前图形界面中的切换开关仅适用于 macOS 系统。从源码构建请参考 `DEVELOPMENT.md`。

使用说明

命令行界面（CLI）：请参考 `USAGE.md`
配置文件：请参考 `CONFIGURATION.md`
开发相关：请参考 `DEVELOPMENT.md`

致谢

Windows 系统支持、摄像头功能和国际化由 @davidbudnick 贡献。
键盘 RGB 灯光、Windows 系统支持、罗技网络摄像头支持由 @davidbudnick 提供。
Linux 系统移植由 @cserby 完成。
开源 HID++ 实现参考了 @pwr 的 Solaar 项目。
本地、无账户的 Options+ 替代方案灵感来源于 @TomBadash 的 Mouser 项目。

许可证

本仓库中的代码采用双重许可，你可以选择 Apache License 2.0（`LICENSE - APACHE`）或 MIT 许可证（`LICENSE - MIT`）。第三方代码 `crates/openlogi - hidpp` 是 @lus 的 hidpp 项目的派生版本，采用 0BSD 许可证。

标志与品牌资产

感谢 @kubai087 设计了 OpenLogi 标志。OpenLogi 标志和应用图标（位于 `design/` 目录下的品牌资产）版权归 2026 AprilNEA 所有，保留所有权利，不适用上述 MIT/Apache 许可证，请参考 `design/LICENSE`。分叉代码并不意味着你拥有使用 OpenLogi 名称、标志或图标的权利，未经事先书面许可，请不要在自己的项目、分叉版本或发行版中使用这些内容。本项目与罗技公司无关，“Logitech”、“MX Master” 和 “Options+” 是罗技国际有限公司的商标。