news 2026/9/12 3:18:02

OpenLogi 新手教程：10 分钟完成安装、授权与鼠标按键重映射（全程免费）

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
OpenLogi 新手教程：10 分钟完成安装、授权与鼠标按键重映射（全程免费）

OpenLogi 新手教程：10 分钟完成安装、授权与鼠标按键重映射（全程免费）

【免费下载链接】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

OpenLogi 是 Rust 编写的罗技设备管理工具，Options+ 的免费开源替代：HID++ 直连鼠标与键盘，无账号、无遥测，配置仅一个本地 TOML 文件。本文带你走通安装、首次连接授权与第一次鼠标按键重映射。

谁适合装 OpenLogi

  • 受够了 Options+：账号、联网、云端数据一样不少。你只想要一个本地文件装下全部设置——这正是 OpenLogi 的默认形态。
  • 在 Linux 上用罗技设备：它是主流发行版的一等公民，Solaar 给不了的按钮重映射玩法，在这里补齐。
  • 想给侧键换活儿：把Back键改成"按住说话"的Ctrl+Space，或让同一个按钮在不同应用里干不同的事。
你的需求OpenLogi 的做法你拿到的效果
摆脱云端配置单文件明文 TOML，本地读写随便同步、随便 diff、可入版本库
侧键改动作任意物理按钮绑动作目录或自定义快捷键长短按区分、按住才触发
按应用切行为per_app_bindings覆盖层随焦点自动切换同一侧键，编辑器里是撤销，浏览器里是后退
滚轮手感SmartShift 档位与灵敏度直写硬件棘轮 / 自由旋转随手调

安装与首次跑通

安装前自查

两件事，各花 30 秒：

  • 退出冲突程序：先关 Logi Options+（Linux 上是 Solaar）。两者抢同一接收器的 HID++ 独占权，同时跑必有一个丢设备。
  • 核系统版本：macOS 13+；Linux 预编译包要 GLIBC 2.35+（Ubuntu 22.04 起步）；Windows 10 / 11，x86_64 与 arm64 均有包。

三个平台的最短安装路径

macOS 一条命令：

brew install --cask openlogi

Windows 下载.msi按用户安装最省事；用免安装.zip时，OpenLogi.exe与openlogi-agent.exe必须放同一目录——agent 独占全部设备 I/O，缺了它 GUI 就是空壳。

Linux 按发行版装包（自动写入 udev 规则，免 sudo 访问/dev/hidraw*与/dev/uinput），再启用后台代理：

sudo dpkg -i openlogi-*.deb systemctl --user enable --now openlogi-agent.service

Fedora 换rpm -i、Arch 换pacman -U，命令同构。

首次运行与连接验证

  • macOS：首次启动按系统弹窗授予辅助功能与输入监控权限——按钮重映射依赖输入钩子。
  • Linux：打开 GUI设置 → 权限页，看到Granted即通过；设备在规则装好前就连上的话，重插一次接收器让 udev 重发 ACL。
  • 验证：终端执行——
openlogi list

输出里出现设备的插槽号、代号、在线状态与电池百分比，即连接成功。

核心实操：完成第一次鼠标按键重映射

第 1 步：选中按钮— 打开 GUI 主窗口，进入该设备的Buttons面板，点选要改的按钮，例如Back。

第 2 步：指定动作— 从内置动作目录里选（如BrowserBack）。要自定义就录入快捷键：CustomShortcut按下即发一组按键；HoldShortcut的组合键会一直保持按下，直到你松开物理键——中键绑Ctrl+Space做语音开麦，松键即停。

第 3 步（可选）：长短按区分— 用{ short = ..., long = ... }写一对动作：500 ms 内松开触发短按，按住满 500 ms 触发长按。一个按钮，两套行为。

第 4 步（可选）：按应用覆盖—per_app_bindings让同一按钮随焦点切换动作，比如 VS Code 在前台时Back变成"撤销"。

第 5 步（可选）：动作环— 给任意按钮绑ShowActionsRing，光标处弹出 8 槽环形动作盘，支持按应用单独布局。

所有改动即时写盘，点完就生效。

进阶：配置文件与自定义

GUI 和 agent 读同一份文件：macOS / Linux 在~/.config/openlogi/config.toml，Windows 在%USERPROFILE%\.config\openlogi\config.toml。核心字段示例（完整样例见 config.example.toml）：

schema_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 错误位置，修好文件重启即可，不会静默回退默认值。把dpi_presets配上CycleDpiPresets动作绑到按钮上，侧键即可循环切 DPI，不走系统弹窗；smartshift.mode在棘轮与自由旋转之间切换，auto_disengage调节触发灵敏度。

排障自查

症状原因与解法
设备列表为空Options+ 或 Solaar 仍在运行——退出冲突程序后再启动 OpenLogi
Linux 钩子装不上检查/dev/uinput、/dev/hidraw*权限（设置 → 权限页），重插接收器让 udev 重发规则
GUI 变只读并报错TOML 写错字段——错误信息精确到位置，修复后重启
侧键按下没反应按钮未捕获或未绑定——回 Buttons 面板确认绑定，蓝牙设备先重插
想查设备底层能力跑openlogi diag features与openlogi diag controls，HID++ 特性清单一次看全

走完这条流程，你的鼠标按键已经脱离 Options+ 的云端托管，落在一个可以 diff 的文本文件里。DPI 预设、SmartShift 与键盘全局快捷键的完整字段见 配置参考，更多诊断命令见 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），仅供参考

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/9/12 3:17:25

React Native for OpenHarmony组件开发：从基础组件到通信实战

1. 项目系列回顾与组件学习路线1.1 上一篇跑通了什么，这一篇要解决什么RN for OpenHarmony（下文简称 RNOH）学到今天，最重要的一个概念就是组件。上一篇我们把环境搭好，项目能跑起来，这一篇就专门来啃组件这…

作者头像 李华
网站建设 2026/9/12 3:13:07

ToF相机全链路解析：从光机电硬件到V4L2驱动与点云落地

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华
网站建设 2026/9/12 3:11:48

技术播客制作全攻略：从设备选型到内容传播

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华
网站建设 2026/9/12 3:10:07

AES加密模式详解：从ECB到GCM的安全演进与实践

1. 加密模式演进背景与核心需求现代加密算法中，AES（Advanced Encryption Standard）作为对称加密的黄金标准，其加密模式的选择直接影响着数据安全级别。2001年成为美国联邦标准后，AES逐步取代DES成为行业主流。但很多开…

作者头像 李华
网站建设 2026/9/12 3:09:53

拼多多多多客联盟CPS工具包：解压、API对接与订单佣金同步实战

简介：拼多多多多客联盟 CPS 工具包是一份面向电商推广者、运营人员及 Python 开发者的实用资源，主要解决多多客联盟营销中的推广链接生成、订单跟踪和佣金结算等对接难题。整个压缩包共 47 个文件，体积仅 63KB，结构以 DDK_SDK-mas…

作者头像 李华
网站建设 2026/9/12 3:08:30

ReVanced Manager 打补丁失败或补丁后应用崩溃怎么排查

ReVanced Manager 打补丁失败或补丁后应用崩溃怎么排查 【免费下载链接】revanced-manager 💊 Application to use ReVanced on Android 项目地址: https://gitcode.com/GitHub_Trending/re/revanced-manager 用 ReVanced Manager 给 Android 应用打补丁时&…

作者头像 李华