OpenLogi：罗技设备本地管理工具

项目简介

OpenLogi 是一款用 Rust（GPUI）编写的罗技外设管理工具，定位是 Logitech Options+ 的原生、本地优先替代品。它通过 HID++ 与 UVC 协议直接与罗技鼠标、键盘和摄像头通信，不需要账号，也不收集遥测数据。

项目支持 macOS、Linux 和 Windows，其中 Linux 被视为一等平台。作者明确说明项目仍在活跃开发中，功能和配置都可能继续变化。

主要功能

设备管理

• 支持 Logi Bolt、Unifying 接收器、蓝牙与有线连接，显示电量与充电状态
• 低电量提示，每次放电只提醒一次，不依赖系统通知权限
• 键盘 Caps Lock 开/关的屏幕指示，Windows 与 Linux 上还包括 Num Lock 和 Scroll Lock
• Easy-Switch：查看各通道配对的电脑及其系统和连接方式，支持的设备可重命名通道

按键与动作

• 重映射任意按键：内置动作目录、自定义快捷键、输入文本、多步工作流
• 轻按与长按动作可分开设置，支持按住说话的组合键
• 中键、前进/后退、DPI/ModeShift、手势键与触觉面板上可配置手势
• Actions Ring：光标周围八个动作槽，可按应用配置独立布局
• 键盘专用键（媒体、emoji、截图等）可像鼠标按键一样绑定，支持单键恢复默认或整行重置
• 按应用切换的配置文件，[apps] 别名可让同一配置跨平台跟随应用

指针与滚轮

• DPI 预设与循环/切换预设动作、指针速度、回报率，Precision Mode 一键切到最慢速度
• SmartShift 滚轮模式与灵敏度，SmartShift Enhanced 鼠标可调滚动阻尼，另有永久棘轮开关
• 滚轮反转（原生或软件实现）、滚轮分辨率、平滑滚动
• 无拇指滚轮的鼠标可按住后退/前进再滚轮来横向滚动

键盘与灯光

• Fn Lock，多平台键盘保持宿主机系统布局
• 背光亮度、自动亮度、省电、亮灯时长，亮度变化有屏幕提示，支持的键盘提供静态 RGB
• Litra 灯：电源、亮度、色温，可跟随摄像头开启，保留在灯上直接做的调整

摄像头

• 任意罗技 UVC 摄像头（Brio、StreamCam、C920 系列等）即插即用
• 实时预览只在你查看时占用摄像头，关闭后指示灯熄灭
• 预览分辨率与帧率可选（只影响 OpenLogi 自己的预览）
• 缩放、平移、俯仰、对焦、曝光、白平衡等 UVC 控制写入硬件，Meet、Zoom、OBS 也能看到变化
• 内置 Default、Streaming、Video call 配置，并支持按摄像头保存自定义快照

配置与自动化

• 所有设置保存在一个纯文本 TOML 文件中，可自行跨机器同步
• GUI 之外提供 CLI 和 JSON 自动化 API，可设置 DPI、SmartShift、Fn-lock、回报率，并进行硬件诊断

安装与使用

应用提供 macOS、Windows 与 Linux 版本，安装包可在 GitHub Releases 获取，官网为 openlogi.org。Linux 上另有名为 openlogi 的 AUR 包（见项目 Linux 文档）。

使用方式是打开应用后在设备列表中选择设备，再在按键、指针、滚轮、键盘、灯光、摄像头等卡片里调整参数，改动即时写入设备或保存在 TOML 配置中。

注意事项

• 项目仍在活跃开发中，尚未稳定，功能和配置格式都可能变化。
• 功能覆盖取决于设备上报的能力，应用只显示设备实际支持的控制项。
• Linux 上部分功能受限：不支持键盘 F 键重映射；按应用配置在 X11、wlroots（sway、Hyprland）以及安装配套扩展的 GNOME 上可用；鼠标配置跟随指针下窗口仅限 X11；没有托盘图标；媒体键通过 D-Bus MPRIS。
• 摄像头预览的分辨率与帧率只影响 OpenLogi 自身的预览画面，不改变其他应用获得的视频。
• 在 macOS 与 Windows 上，如果摄像头接在比其能力更慢的 USB 链路（USB 2 端口、集线器或线缆），应用会给出提示。

本作品整理自 GitHub 开源项目 AprilNEA/OpenLogi，原作者 @AprilNEA，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。