📌 项目地址:AprilNEA/OpenLogi | ⭐ 15,700 颗星 | 🔧 Rust | 📜 未标注
这个项目解决什么问题
罗技官方的 Options+ 有一堆毛病:常驻后台吃资源、要装一整套软件才能改个按键、Linux 上干脆没有。OpenLogi(AprilNEA/OpenLogi,Rust,15700 星)就是冲着这些来的——一个本地优先的替代品,跑在 macOS、Linux、Windows 三平台上。
README 第一行是警告:项目还在活跃开发,没有稳定版,功能和配置格式都可能变。所以这篇文章讲的是它做了什么、做得对在哪,不是装机指南。
几个硬差异
- 原生 Rust + GPUI,不用 Electron
- Linux 是一等公民
- 全部配置就是一个 TOML 文本文件,想用 Git、网盘还是 rsync 同步都行,没有账号系统
- GUI 之外有真的 CLI,可以脚本化
手势这块给的选择权 Options+ 从没给过:可以把手势角色指派给任意物理按键,按方向分别绑定,支持实时捕获;或者干脆把手势整个关掉。
鼠标:协议层功夫做得最深的部分
按键重映射走 OS 输入钩子。中键所有设备都能改,模式切换键和拇指轮取决于设备是否暴露这些功能。短按和长按可以绑不同动作,还支持“按住生效、松开结束”的和弦键——push-to-talk 就靠这个实现。
Actions Ring 是以光标为中心弹出的八格动作面板(配置项叫 ShowActionsRing),每个应用可以配不同布局。配合按应用自动切换的 profile(应用拿到焦点就换按键方案),能搭出很细的工作流。限制要说清楚:这个自动切换在 macOS 和 Windows 可用,Linux 只支持 X11 / XWayland,原生 Wayland 不行。
协议层的功能码 README 写得明明白白:DPI 预设和 Cycle / Set-preset 动作走 0x2201;SmartShift 滚轮的模式切换、灵敏度调节、永久棘轮走 0x2111;每设备独立的滚轮方向反转走 0x2121。这些是罗技 HID++ 私有协议里的功能码,作者是真在啃协议文档干活。
键盘
全局 F 键重映射,动作目录和鼠标共用。另有进阶动作:键入文本、组合键、多步工作流(后两项仅 macOS + Windows)。静态 RGB 灯光对应 0x8070 / 0x8080 两个功能码,限支持的设备。
摄像头:改的是硬件,不是软件滤镜
这是我觉得最有意思的模块。支持任意罗技 UVC 摄像头——Brio、StreamCam、C920 系列,即插即用。
关键区别:变焦、对焦、曝光、亮度、对比度、饱和度、锐度、白平衡、色调、防闪烁、低光补偿,这些参数直接写进 UVC 硬件,对焦、曝光、白平衡各有 auto 模式开关。改的是摄像头本身,所以在 OpenLogi 里调好的画面,Meet、Zoom、OBS 读到的是同一套值——所有软件读的都是同一颗硬件。
预览的实现也讲究:只在你看的时候打开摄像头,关掉预览就完全释放设备,LED 熄灭。
还有一键切换的画面配置(One-click profiles),README 提到内置了 Default 一档,文档在这里截断了,具体几档去仓库确认。
外围功能
- 连接方式覆盖 Logi Bolt 接收器、Unifying 接收器、蓝牙、有线,能读电量百分比和充电状态
- Litra 补光灯控制:电源、亮度、色温,可选跟随摄像头活动自动开关
装之前想清楚
- 没有稳定版,配置格式可能变,别急着装主力机
- RGB、滚轮反转等功能依赖具体设备型号,不是所有罗技产品都支持
- 摄像头参数写在硬件层,对所有软件生效——多数时候这正是你要的,但得知道它在改什么
- 原生 Wayland 用户用不了按应用自动切换
我的判断
罗技外设的开源替代喊了很多年,做完整的没几个,卡住大家的就是协议逆向的工作量。OpenLogi 有两点做对了:一是真碰 HID++ 和 UVC 协议层,二是配置收敛到一个 TOML 文件,local-first 不是口号。15700 颗星说明等这个东西的人不少。
README 目前没列完整的 TOML 配置项和 CLI 命令,项目确实在早期。手上有几件罗技设备、或者在 Linux 上一直没得选的人,现在 Star 加 Watch,等 Release 就行。