安装

支持 macOS 与 Linux。Windows 处于未经测试的早期预览阶段——每个发行版都附带签名构建（参见路线图）。

安装或启动 OpenLogi 前请先退出 Logi Options+——两者会争夺 HID++ 访问权，同一时间只能有一个占用接收器。在 Linux 上，Solaar 同理。

macOS


brew install --cask openlogi

从最新发行版获取已签名并公证的 .dmg。

打开 .dmg，将 OpenLogi.app 拖入 /Applications。

首次启动时，macOS 可能要求你确认该应用，并授予辅助功能（Accessibility） / 输入监控（Input Monitoring） 权限——通过操作系统事件钩子重映射按键时需要。

从最新发行版下载 .deb 或 .rpm——安装包同时提供 x86_64/amd64 与 arm64/aarch64 两种架构：


# Debian / Ubuntu
sudo dpkg -i openlogi_*.deb
 
# Fedora / RHEL
sudo rpm -i openlogi-*.rpm

安装包会写入 udev 规则，让你的用户无需 sudo 即可访问 /dev/hidraw*（HID++ 命令）与 /dev/uinput（虚拟重映射设备）。然后为当前用户启用后台 agent：


systemctl --user enable --now openlogi-agent.service

如果安装 udev 规则时设备已经插着，请拔下并重新插入接收器（或重启设备电源），让新规则生效。GUI 的 设置 → 权限 页面有实时的访问状态指示。

手动 / 源码安装以及无 systemd 的发行版，参见 INSTALL-linux.md 。

每个发行版都附带签名的 .exe 与按用户安装的 .msi（x86_64 与 arm64）。Windows 支持仍处于早期预览，尚未在真实硬件上充分测试——请预期一些粗糙之处，并欢迎反馈问题。

参见仓库中的 DEVELOPMENT.md 。