用 OpenLogi 给罗技鼠标重映射按键：一份本地 config.toml 免费搞定全部设置

用 OpenLogi 给罗技鼠标重映射按键一份本地 config.toml 免费搞定全部设置【免费下载链接】OpenLogi⚡️A native, local-first alternative to Logitech Options, written in Rust — remap buttons, DPI, and SmartShift over HID. No account, no telemetry.项目地址: https://gitcode.com/GitHub_Trending/op/OpenLogi受够了 Options 的账号、联网和云端配置OpenLogi 是罗技设备管理工具 Options 的免费开源替代Rust 编写走 HID 直连鼠标和键盘无遥测。跟着本文 10 分钟走一遍安装、授权和第一次改键你的按键配置从此只落在一个本地 TOML 文件里。改完之后你会得到什么所有按键、DPI、滚轮配置写进一份明文config.toml可以 diff、可以同步、可以入版本库同一个侧键在不同应用里干不同的事长短按也能分开定义行为SmartShift 档位和灵敏度直接写进硬件棘轮还是自由旋转随手就调。装前 60 秒确认退出冲突程序先关掉 Logi OptionsLinux 上则是 Solaar。两者都抢同一个接收器的 HID 独占权同时跑必有一个丢设备。核一下系统版本macOS 13Linux 预编译包需要 GLIBC 2.35Ubuntu 22.04 起步Windows 10 / 11x86_64 与 arm64 均有包权限预期macOS 首次启动会弹辅助功能与输入监控授权按钮重映射依赖输入钩子Linux 需要/dev/uinput写权限与/dev/hidraw*读写权限装包时自动写入 udev 规则免 sudo。从 0 到设备上线安装命令按平台各取一条# macOS brew install --cask openlogi # LinuxDebian 系示例Fedora 换 rpm -iArch 换 pacman -U sudo dpkg -i openlogi-*.deb systemctl --user enable --now openlogi-agent.serviceWindows 直接装.msi最省事如果选免安装.zip记住OpenLogi.exe与openlogi-agent.exe必须放同一目录——agent 独占全部设备 I/O缺了它 GUI 就是个空壳。装完做三件验证macOS按系统弹窗授予辅助功能与输入监控Linux打开 GUI设置 → 权限页状态显示Granted即通过。设备如果在 udev 规则装好前就连上了把接收器重插一次让它重发 ACL确认上线终端跑openlogi list输出里出现设备的插槽号、代号、在线状态与电池百分比连接就算打通了。侧键改键最快的三种做法进 GUI 主窗口在对应设备的Buttons面板点选要改的按钮三种场景各选各的做法。场景一侧键做语音开麦按住才触发你要的效果中键按住CtrlSpace持续保持按下松键即停——典型的语音开麦用法。怎么改选中中键绑定类型选HoldShortcut录入CtrlSpace。区别要记牢CustomShortcut是按下就发一组按键HoldShortcut则一直保持组合键按下直到你松开物理键开麦必须用后者。如何确认按下中键麦克风进麦松开立刻停。场景二同一个侧键不同应用干不同的事你要的效果Back键在浏览器里后退切到 VS Code 前台时自动变成撤销。怎么改先用动作目录把默认动作绑成BrowserBack再在 GUI 里为 VS Code 添加per_app_bindings覆盖把Back指向撤销。覆盖层随焦点自动切换不用你手动切。如何确认浏览器里按Back后退切到 VS Code 再按执行的是撤销。场景三一个按钮两套行为长短按区分你要的效果快速点按显示桌面按住不动则打开 Mission Control。怎么改给按钮绑定一对动作TOML 写法是{ short ShowDesktop, long MissionControl }。阈值是 500 ms500 ms 内松开触发short按住满 500 ms 触发一次long。如何确认快速点一下、慢按住各试一次两种动作分别触发互不干扰。三个场景都验证完之后可以给任意按钮再加个ShowActionsRing光标处弹出一个 8 槽环形动作盘支持按应用单独布局相当于把常用动作捏在手边。一份 config.toml 管全部GUI 和 agent 读写的是同一个文件三个平台路径如下平台配置路径macOS / Linux~/.config/openlogi/config.tomlWindows%USERPROFILE%\.config\openlogi\config.toml核心字段长这样完整样例见 docs/config.example.tomlschema_version 7 [devices.receiver:aabbccdd:slot:1] dpi 1600 dpi_presets [800, 1600, 3200] [devices.receiver:aabbccdd:slot:1.bindings] Back BrowserBack [devices.receiver:aabbccdd:slot:1.smartshift] mode ratchet写入机制可以完全放心GUI 采用原子写入并保留config.toml.backup.1至config.toml.backup.5共五份备份。schema 校验很严格——字段拼错或取值越界时GUI 进入只读模式并给出精确到位置的 TOML 错误修好文件重启即可不会静默回退默认值。顺带两个进阶玩法把CycleDpiPresets动作绑到按钮侧键就能在dpi_presets之间循环切档不经过系统弹窗smartshift.mode在棘轮与自由旋转之间切换auto_disengage调节触发灵敏度全部直写硬件。出问题先查这张表症状先查什么解法设备列表为空Options 或 Solaar 是否还在运行退出冲突程序后再启动 OpenLogiLinux 钩子装不上/dev/uinput、/dev/hidraw*权限设置 → 权限页重插接收器让 udev 重发规则GUI 变只读并报错TOML 是否写错字段错误信息精确到位置修复后重启侧键按下没反应按钮是否已捕获并绑定回 Buttons 面板确认蓝牙设备先重插想看设备底层能力无跑openlogi diag features与openlogi diag controlsHID 特性清单一次看全走完上面这条线你的按键配置已经脱离 Options 的云端托管落进了一个可以随手 diff 的文本文件里。DPI 预设、SmartShift 与键盘全局快捷键的完整字段见 docs/CONFIGURATION.md更多诊断命令见 docs/USAGE.md 【免费下载链接】OpenLogi⚡️A native, local-first alternative to Logitech Options, written in Rust — remap buttons, DPI, and SmartShift over HID. No account, no telemetry.项目地址: https://gitcode.com/GitHub_Trending/op/OpenLogi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考