OpenLogi

重映射按键

为受支持的鼠标控件设置操作、手势,以及后退或前进按键的滚轮按住模式。

在鼠标的按键(Buttons)标签页中更改受支持的控件。每个控件使用单个操作、五方向手势图,或后退 / 前进按键的滚轮按住模式。

在 GUI 中

选择鼠标后,打开按键(Buttons)。点击热点圆点或标签卡,即可打开控件检查器。

MX Master 4 的按键标签页,已打开手势按键检查器

按键标签页,已选中手势按键。

标签卡显示有效绑定。没有绑定时,它显示未绑定。

  • 操作选择器 —— 搜索标准操作列表。不执行任何操作会捕获输入,但不合成操作系统事件。
  • 自定义快捷键 —— 选择轻按或按住,输入组合键(例如 Cmd+Shift+P 或 PageUp),再点击添加。轻按写入 CustomShortcut,按住写入 HoldShortcut。
  • 打开应用或文件夹 —— 输入应用、文件夹、路径或 URL。选择器可直接编写此操作。
  • 默认配置文件 —— 该配置文件更改设备级绑定。应用配置文件中的每个按键只有一个操作。使用默认配置文件会删除此按键的覆盖。

鼠标选择器不能编写 TapKeyHoldingModifiers、TypeText、RunAppleScript、RunShellCommand 或 Workflow。这些操作必须写入 TOML。

需要平台徽标修饰键时,在自定义快捷键中使用 Super。macOS 将它映射为 Command。Linux 和 Windows 将它映射为 Super 或 Windows 键。

自定义快捷键可以只有一个键,不带修饰键。除字母、数字、标点、F1 到 F20、Enter、Escape、Backspace、Tab、Space 和方向键外,还可以使用编辑键 Insert(Ins)、Delete(Del)、Home、End、PageUp(PgUp)和 PageDown(PgDn)。键名不区分大小写。在 macOS 上,Insert 按下的是 Help 键。

按平台区分的操作

同一操作名在不同平台可能使用不同的原生路径。

操作macOSLinuxWindows
MissionControl发送 Dock 通知。GNOME 打开活动概览。KDE 使用 KWin Overview。Hyprland 跳过此操作。发送 Win+Tab。
AppExpose发送 Dock 通知。KDE 使用 KWin ExposeClass。GNOME 和 Hyprland 跳过此操作。发送 Win+Tab。
ShowDesktop发送 Dock 通知。GNOME 发送 Super+D。KDE 使用 KWin。Hyprland 跳过此操作。发送 Win+D。
LaunchpadShow发送 Dock 通知。GNOME 发送 Super+A。Hyprland 使用原生辅助程序或重映射。其他会话跳过它。发送 Windows 键。
PreviousDesktop / NextDesktop发送 Dock 桌面滑动。KDE 使用 KWin D-Bus。其他会话使用快捷键路径。Hyprland 使用原生辅助程序或重映射。发送 Win+Ctrl+Left / Right。
Screenshot执行原生全屏截屏。发送 Print Screen。发送 Win+PrtScn。
CaptureRegion发送 Cmd+Shift+Ctrl+4。发送桌面环境的区域截屏 Print Screen 组合键。发送 Win+Shift+S。

Linux 缺少原生等价操作时,OpenLogi 会跳过该操作。OpenLogi 不会用范围不同的操作替代它。

手势模式

在默认配置文件中,为受支持控件选择使用手势(Use gestures)。检查器随后显示上、下、左、右和按下操作。

中键单击、后退与前进可以进入手势模式。鼠标上报原始 XY 支持后,灵敏度切换也可以进入此模式。

专用手势按钮与 MX Master 4 的触感面板也可使用手势。M720 Triathlon 的多平台拇指按钮会被识别为手势按钮。MX Ergo 的精确模式槽位映射为 DpiToggle。

按住手势按钮时可以连续触发手势。保持按住后,再做一次滑动即可触发另一个方向。

鼠标上报原始滚轮支持时,后退与前进可使用按住时水平滚动(Hold to scroll sideways)。按住按键期间,主滚轮向左或向右滚动。

按下后未转动滚轮时,仍会运行此按键的点击操作。滚轮按住模式与手势模式不能同时用于同一个按键。

滚动行为详见按住时水平滚动。

捕获路径

OpenLogi 通过操作系统钩子捕获常规的中键单击、后退与前进输入。它通过 HID++ 0x1b04 reprogControlsV4 转移受支持的设备控件。

HID++ 路径涵盖专用手势按钮、触感面板与受支持的 DPI / ModeShift 控件。设备上报所需控件数据时,它还支持 Windows 上的 HID++ 侧键手势。

绑定变化后,代理会重建按设备划分的捕获计划。未被有效绑定或内置手势需要的控件会保留固件行为。

在配置中

绑定使用物理设备键。此示例展示修饰键按住轻按、滚轮按住、短按 / 长按组合与手势图:

[devices."unit:6be9d300".bindings]
Back = { TapKeyHoldingModifiers = "Alt+Tab" }
Forward = { click = "BrowserForward", wheel = "HorizontalScroll" }
MiddleClick = { short = "Copy", long = "Paste" }

[devices."unit:6be9d300".bindings.GestureButton]
Up = "MissionControl"
Down = "AppExpose"
Left = "PreviousDesktop"
Right = "NextDesktop"
Click = "ShowActionsRing"

CustomShortcut 会立即轻按完整组合键。HoldShortcut 会持续按住修饰键和普通键,直到物理按键松开。

TapKeyHoldingModifiers 会轻按普通键一次,再持续按住修饰键,直到松开。它可以在收到 Alt+Tab 后保持应用切换器打开。

短按 / 长按组合只能在 TOML 中编写。500 ms 前松开会运行 short。达到 500 ms 时会运行一次 long。

完整操作与绑定形式见配置。

按应用绑定

按应用绑定中的每个按键只能使用一个操作。它不能保存手势方向、短按 / 长按组合或滚轮按住行为。

应用覆盖可在一个应用中替换全局操作。清除该覆盖后,按键会再次继承默认配置文件。

目标选择与叠加规则见按应用配置。

**状态:**macOS、Linux 与 Windows 均可用。设备侧捕获使用 0x1b04 specialKeysMSEButtons。

本页目录