安装 – OpenLogi Docs

如何通过 Homebrew、包管理器或直接下载，在 macOS、Linux 或 Windows 上安装 OpenLogi。

macOS、Linux 与 Windows 均受支持。Windows 是最新的移植——已在 Windows 11 硬件上端到端验证，但毛边比另外两个平台多一些（参见路线图）。

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

macOS

需要 macOS 13 或更高版本。

Homebrew

brew install --cask openlogi

官方 cask 是默认安装方式。若希望跟随最新的 GitHub 发行版：

brew tap aprilnea/tap
brew install --cask aprilnea/tap/openlogi@latest

openlogi 与 openlogi@latest 二选一，不要同时安装。

安装应用

打开 .dmg，把 OpenLogi.app 拖到 /Applications。

启动并授予权限

首次启动时，macOS 可能会要求你确认该应用，并授予辅助功能 / 输入监控权限——通过系统事件钩子重映射按键需要它。摄像头预览还需要摄像头权限。

Linux

下载适合你发行版的安装包——每种格式都同时提供 x86_64/amd64 与 arm64/aarch64：

# Debian / Ubuntu
sudo dpkg -i openlogi_*.deb

# Fedora / RHEL
sudo rpm -i openlogi-*.rpm

# Arch Linux
sudo pacman -U openlogi-*.pkg.tar.zst

直链：.deb · .rpm · .pkg.tar.zst。

安装包会写入 udev 规则，让你的用户无需 sudo 即可访问 /dev/hidraw*（HID++ 命令）、/dev/uinput（用于重映射的虚拟输入设备）以及罗技鼠标的 /dev/input/event* 节点。随后为你的用户启用后台代理：

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

如果安装 udev 规则时设备已经插着，请拔插接收器（或让无线设备重新上电），让新规则生效。GUI 的设置 → 权限页面会实时显示访问状态。

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

Windows

下载已签名的 .msi 安装包：x86_64 或 arm64。每个发行版还附带免安装的 .zip 构建。

两者都同时包含 GUI（OpenLogi.exe）与后台代理（openlogi-agent.exe），后者独占全部设备 I/O——使用免安装 zip 时请把两个文件放在一起，否则 GUI 无处可连。代理会显示通知区域图标（显示主窗口 / 退出），因此主窗口关闭后应用依然可达；若想隐藏它，请在 TOML 的 [app_settings] 中设置 show_in_menu_bar = false 并重启代理（GUI 上的开关目前仅 macOS 可用）。

从源码构建

见仓库中的 DEVELOPMENT.md。

安装