警告OpenLogi 正在积极开发中尚未稳定其功能和配置可能仍会发生变化。给该仓库点个星 ⭐ 并关注 它以便在新版本发布时收到通知。[English](链接) | [简体中文](链接) | [日本語](链接) | [Deutsch](链接) | [Français](链接) | [한국어](链接)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/tapbrew install --cask aprilnea/tap/openlogilatestopenlogilatest 由 OpenLogi 的发布工作流维护可能会在官方 cask 自动更新之前更新。请选择安装 openlogi 或 openlogilatest 其中之一不要同时安装。Linux从最新版本中下载适合你发行版的软件包Debian / Ubuntusudo dpkg -i openlogi_*.debFedora / RHELsudo rpm -i openlogi-*.rpmArch Linuxsudo 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-linuxmodules [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.0LICENSE - 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” 是罗技国际有限公司的商标。仓库活动[此处可添加仓库活动相关内容原文未详细说明] OpenLogi：用 Rust 编写的 Logitech Options+ 替代方案，多系统支持且功能强大！
警告OpenLogi 正在积极开发中尚未稳定其功能和配置可能仍会发生变化。给该仓库点个星 ⭐ 并关注 它以便在新版本发布时收到通知。[English](链接) | [简体中文](链接) | [日本語](链接) | [Deutsch](链接) | [Français](链接) | [한국어](链接)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/tapbrew install --cask aprilnea/tap/openlogilatestopenlogilatest 由 OpenLogi 的发布工作流维护可能会在官方 cask 自动更新之前更新。请选择安装 openlogi 或 openlogilatest 其中之一不要同时安装。Linux从最新版本中下载适合你发行版的软件包Debian / Ubuntusudo dpkg -i openlogi_*.debFedora / RHELsudo rpm -i openlogi-*.rpmArch Linuxsudo 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-linuxmodules [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.0LICENSE - 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” 是罗技国际有限公司的商标。仓库活动[此处可添加仓库活动相关内容原文未详细说明]