OpenLogi

介绍

原生、本地优先的 Logitech Options+ 替代品,使用 Rust 编写。无需账号,无遥测。

一个使用 Rust 编写的本地优先的 Logitech Options+ 平替。

重新映射按键,调节 DPI、回报率与 SmartShift,按应用切换配置。无需 Logitech 账号,没有遥测,也无需安装官方 Options+。

OpenLogi 正在积极开发中,尚不稳定,功能与配置仍可能变化。

介绍

OpenLogi 通过 Logi Bolt、Unifying 与 Lightspeed 接收器、蓝牙直连或 USB 线缆,直接与 Logitech HID++ 外设通信,无需运行 Logi Options+。一切都留在本机:按键绑定保存在纯 TOML 文件中,按键通过操作系统输入钩子重映射,DPI、SmartShift、滚动与灯光的更改通过 HID++ 直接写入设备。

它能驱动什么

  • 鼠标:按应用的按键绑定、手势、短按与长按、按住快捷键、DPI 预设、回报率、SmartShift 与滚动力度、滚轮反转、滚轮分辨率、平滑滚轮、按住时水平滚动、拇指滚轮,以及 MX Master 4 的 Haptic Sense 触感面板。
  • 键盘:HID++ 按键绑定、功能键重映射、Fn 锁定、保持系统布局、背光,以及静态 RGB 颜色。
  • Easy-Switch:每个通道上配对的计算机、为通道上的计算机改名,以及让关联设备随键盘一起切换主机。
  • Litra 补光灯:开关、亮度、色温,以及在 macOS 上随摄像头自动点亮。
  • 摄像头:UVC 图像控制、摄像头配置文件与实时预览。
  • 耳机:G733 的电量与连接状态。
  • 屏幕提示:低电量、锁定键变化与键盘背光亮度。

超越 Options+

OpenLogi 能做、而 Options+ 做不到的事:

  • 跑在 Linux 上。 Options+ 只有 macOS 和 Windows 版本。OpenLogi 把 Linux 当作一等公民:evdev/uinput 钩子、udev 规则、systemd 用户单元、.deb / .rpm / .pkg.tar.zst 安装包、Flatpak 包,以及 GNOME、KDE 与 Hyprland 上的原生桌面动作。
  • 选择手势键。 中键、后退、前进、专用手势键、触感面板,以及报告可接管与 raw-XY 能力的 DPI / 模式切换键都可以绑定方向手势,也可以同时启用多个。参见按键重映射。
  • 纯文本配置。 全部设置就是一个 TOML 文件,可读、可 diff、可纳入版本管理、可在多台机器间复制。[apps] 别名让一个应用配置同时覆盖 macOS、Windows 与 Linux。
  • 可脚本化。 通过 CLI 查询设备清单、使用版本化的 JSON 接口、调节 DPI、回报率、SmartShift、Fn 锁定与 Easy-Switch、预取资源、控制补光灯与摄像头,以及执行 HID++ 诊断。
  • 保持轻量。 原生 Rust 二进制:没有 Electron 全家桶,无账号,无遥测。更新检查默认关闭,由你决定是否开启,详见设置和更新。

文档版本

本指南描述已发布的 v0.8.15(2026 年 10 月 20 日)。最近一次文档更新为 2026 年 10 月 21 日。各版本变化见更新日志。schema 9 与旧配置文件的迁移见配置参考。隐私安全的设备 fixture 录制流程见参与贡献。

快速开始

安装

在 macOS、Linux 或 Windows 上安装 OpenLogi。

连接设备

安装或启动 OpenLogi 前请先退出 Logi Options+

两者会争夺 HID++ 访问权,同一时间只能有一个程序占用接收器。在 Linux 上,Solaar 同理。

通过 Bolt、Unifying 或 Lightspeed 接收器、蓝牙或 USB 连接设备。

配置

打开设备,逐个查看它的标签页。功能指南介绍每个标签页,设置和更新介绍应用级选项。

下一步


与 Logitech 无关联。「Logitech」、「MX Master」和「Options+」是 Logitech International S.A. 的商标。

本页目录