BlackHalo logo
Published on

OpenLogi：Rust 编写的本地优先 Logitech 外设配置工具

Authors
  • Name
    amatheus
    openlogi.org
OpenLogi 软件界面截图，显示鼠标按钮映射配置
头图来源： 来源页面

项目概述

OpenLogi 是一个为 Logitech 外设设计的本地优先配置工具，旨在替代官方的 Logitech Options+。它完全开源，使用 Rust 编写，支持 macOS、Linux 和 Windows 三大平台。与 Options+ 不同，OpenLogi 不需要用户注册账户，也不收集任何遥测数据，所有配置都存储在用户本地的纯文本 TOML 文件中。它通过 HID++ 协议直接与 Logitech 设备通信，实现对鼠标按钮、DPI 和 SmartShift 等功能的精细控制。

核心功能

按钮重新映射

OpenLogi 提供直观的鼠标图表界面，用户可以通过点击热点选择任意物理按钮，然后从内置的 44 种动作中为其绑定新功能。这些动作包括常见的浏览器后退、前进、Mission Control、App Expose、切换标签页等。此外，还支持自定义快捷键、启动应用程序和执行脚本，满足高级用户的需求。

DPI 控制与预设

用户可以通过 HID++ 直接调整鼠标的指针分辨率，范围从 200 到 8000 DPI。可以设置多个预设值，并在它们之间循环切换，所有设置实时写入传感器，无需额外软件。

SmartShift 滚轮模式

OpenLogi 支持 Logitech 的 SmartShift 功能，允许用户在齿感模式和自由旋转模式之间切换。可以设置自动切换的阈值，根据滚动速度让滚轮自动在两种模式间切换，提升操作效率。

设备管理与实时状态

主界面显示一个设备轮播，展示所有已配对的 Logitech 设备，包括电池电量和充电状态。支持通过 Logi Bolt、Unifying、Lightspeed 接收器、蓝牙和 USB 有线连接，覆盖主流 Logitech 外设。

隐私与本地优先设计

OpenLogi 的核心设计原则是本地优先。所有配置数据仅存储在用户本地的 config.toml 文件中，用户完全拥有该文件。没有网络请求，没有云同步，没有账户系统。应用程序不会主动“打电话回家”。更新检查默认关闭，需要用户手动开启。这种设计确保了用户隐私，也避免了数据泄露风险。

配置文件

配置采用 TOML 格式，示例配置如下：

schema_version = 2
selected_device = "2b042"
[devices.2b042.bindings]
MiddleClick = "MissionControl"
DpiToggle = "CycleDpiPresets"
Thumbwheel = "VolumeUp"
Forward = "BrowserForward"
Back = "BrowserBack"
GestureButton = "AppExpose"

配置文件结构清晰，用户可以手动编辑，也可以复制到其他机器上直接使用。设备通过物理标识（接收器序列号和槽位，或设备自身序列号）进行识别，因此同一鼠标的配置可以在不同设备间迁移。

平台支持与安装

OpenLogi 提供针对 macOS、Linux 和 Windows 的签名安装包：

  • macOS：推荐通过 Homebrew 安装（brew install --cask openlogi），或下载 .dmg 文件。
  • Linux：提供 .deb、.rpm 和 Arch .pkg.tar.zst 包，支持 amd64 和 arm64。
  • Windows：提供 .msi 安装程序，支持 x86_64 和 arm64，已在 Windows 11 上验证。

注意：在启动 OpenLogi 前，需要退出 Logitech Options+ 或 Solaar（Linux 上），因为两者会争夺 HID++ 访问权限。

常见问题与未来计划

Logitech Flow 支持？ 已在路线图上，但属于较远期的功能。目前 OpenLogi 已支持通过 HID++ 驱动 Easy-Switch 主机切换，鼠标可跟随键盘切换。未来跨计算机指针与剪贴板功能将作为可选本地网络功能实现。

设备配对？ Bolt 配对已在 GUI 中实现，Unifying 和 Lightspeed 配对正在开发中。在此之前，用户可以使用 Logitech 官方工具或 Solaar 完成首次配对，之后 OpenLogi 即可接管。

导入 Options+ 设置？ 导入器正在开发中，尚未就绪。但手动编写 TOML 配置文件只需几分钟，且比 Options+ 的配置更便携、可编辑。

macOS 辅助功能权限？ OpenLogi 需要通过 CGEventTap 重新映射侧键（后退、前进、中键），因此 macOS 会要求辅助功能权限。HID++ 路径（手势按钮、拇指轮、DPI、SmartShift）不需要此权限。

更新方式？ 仅当用户请求时更新。内置更新检查默认为关闭，新版本可通过 Homebrew 升级或从 Releases 页面下载安装包。

配置迁移？ 复制 TOML 文件即可。设备通过物理身份识别，同一鼠标的配置可在不同机器间直接使用。未来可能加入内置同步功能，但需平衡无账户原则。

总结

OpenLogi 为 Logitech 外设用户提供了一个强大、隐私友好且可控的配置工具。它摆脱了官方软件的网络依赖和账户要求，通过纯本地化的方式实现同等甚至更灵活的功能。对于注重隐私、喜欢自定义且希望完全掌控自己设备的用户来说，OpenLogi 是一个值得尝试的替代方案。

原标题：OpenLogi。 HN 原始发布时间：2026年8月19日星期三。当前记录为 1506 分、401 条评论。

阅读原文 · 查看 HN 讨论