📌 项目地址:AprilNEA/OpenLogi | ⭐ 15,700 颗星 | 🔧 Rust | 📜 未标注
先说结论
AprilNEA/OpenLogi,Rust 写的 Logitech Options+ 替代品,15700 Star。支持 macOS、Linux、Windows,通过 HID++ 协议直接和罗技设备通信。
但有一个前提必须放在最前面:README 明确写了项目还在活跃开发、尚未稳定,功能和配置格式都可能变,正式 Release 还没发。现在的 Star 数说明关注度高,不代表可以无脑装到主力机上。我的建议是先 Watch,等 Release。
Options+ 到底哪里烦人
罗技官方软件的槽点大家都很熟:臃肿、要登录账号、不支持 Linux。如果你只是想改几个按键、调一下 DPI,为此装一个常驻后台的大软件,代价不太划算。
OpenLogi 的答案很直接:原生 Rust + GPUI,配置全在一个 TOML 文件里,不需要账号,附带真正的 CLI 可以脚本化操作。Linux 是一等公民平台。
功能拆开看
鼠标是重头。
按键重映射走 OS 输入钩子,中键、模式切换键、拇指轮都能改,内置动作目录,也可以在 TOML 里写自定义快捷键。手势绑定可以指派给任意物理按键,按方向分别设置、支持实时捕获——不想用手势就整个关掉,这一点 Options+ 做不到。
Actions Ring 是个有意思的设计:以光标为中心弹出八格动作面板(配置项叫 ShowActionsRing),不同应用可以配不同布局。配合按应用自动切换的 profile overlay(应用获得焦点时自动换按键方案),工作流可以做到很细。注意 Linux 上这个功能只在 X11 / XWayland 可用,原生 Wayland 不行。
协议层面的细节 README 写得挺实在:DPI 预设和 Cycle / Set-preset 动作对应 0x2201,SmartShift 滚轮的模式切换、灵敏度、永久棘轮对应 0x2111,每设备滚轮方向反转对应 0x2121。这些数字是罗技 HID++ 私有协议的功能码,也就是说作者是在对着协议逆向文档干活,不是简单包一层系统 API。
键盘支持全局 F 键重映射,除了鼠标那套动作,还有键入文本、组合键、多步工作流这类进阶动作(仅 macOS + Windows)。静态 RGB 灯光对应 0x8070 / 0x8080,限支持的设备。
摄像头部分是惊喜。 支持任意罗技 UVC 摄像头(Brio、StreamCam、C920 系列即插即用),变焦、对焦、曝光、白平衡、防闪烁、低光补偿等参数直接写进 UVC 硬件。这意味着设置在 Meet、Zoom、OBS 里同样生效——改的是摄像头本身,不是软件层的滤镜。预览也做得干净:只在观看时打开摄像头,关掉预览就完全释放设备,LED 熄灭。内置 Default / Streaming / Video call 三个一键 profile,自定义快照按摄像头持久化保存。
顺带还能控制 Litra 补光灯的亮度、色温,可选跟随摄像头开关自动启停。
连接方式上,Logi Bolt 接收器、Unifying 接收器、蓝牙、有线都支持,能读电量百分比和充电状态。
配置:一个 TOML 走天下
整个项目的配置就是一个纯文本 TOML 文件。想同步到多台机器?Git、网盘、rsync,随你。这大概是 local-first 理念最落地的形式:没有云端账号,没有私有格式,文件在你手里。
具体的 TOML 配置项和 CLI 命令,README 目前没有完整列出,需要去仓库文档目录查——这也可以看出项目确实还在开发期。
装之前想清楚这几点
- 没有稳定版,配置格式可能随版本变动,主力机慎装
- RGB 灯光、滚轮反转等功能依赖具体设备型号支持,不是所有罗技产品都全覆盖
- 摄像头参数写入的是硬件层,改动会持久化到相机,其他软件读到的也是改后的值。这通常是你想要的效果,但要知道它在改什么
- Linux 原生 Wayland 用户用不了按应用自动切换
如果你手上正好有几件罗技设备,或者在 Linux 上一直没得用,这个仓库值得 Star 加 Watch。等功能稳定、Release 落地,替换官方软件的可能性不小。