安装
在 macOS、Linux 或 Windows 上安装 OpenLogi v0.8.15,并授予所需访问权限。
OpenLogi 支持 macOS 13 或更高版本、Linux 与 Windows。选择一种适合平台的安装方式,然后完成平台所需的访问设置。
安装或启动 OpenLogi 前请先退出 Logi Options+
macOS
macOS 需要 13 或更高版本。发行版 DMG 已签名并完成公证。
安装官方 Homebrew cask:
brew install --cask openlogi如果要通过 OpenLogi tap 跟随最新 GitHub 发行版,请安装:
brew tap aprilnea/tap
brew install --cask aprilnea/tap/openlogi@latest只能安装 openlogi 或 openlogi@latest 之一,不要同时安装。
从最新发行版下载已签名并完成公证的 DMG。打开 DMG 后,把 OpenLogi.app 拖到 /Applications。
安装后启动 OpenLogi,并按提示授予权限。为 OpenLogi Agent 授予辅助功能(Accessibility)与输入监控(Input Monitoring);前者启用手势和按键重映射,后者读取 HID++ 数据,包括蓝牙直连鼠标。
只有要预览 Logitech 摄像头时,才授予摄像头(Camera)权限。该权限属于 OpenLogi 应用,不属于代理进程,且与 HID 和输入访问相互独立。
Linux
发行版提供适用于 x86_64/amd64 和 arm64/aarch64 的 .deb、.rpm 与 .pkg.tar.zst 软件包。预构建软件包需要 GLIBC 2.35 或更高版本,基线为 Ubuntu 22.04。
验证发行版安装程序
先用发行版包管理器安装 minisign。通过 HTTPS 下载安装程序并审阅。必须以普通用户运行。不要把它通过管道传给 shell,也不要用 sudo 运行整个脚本。
curl --proto '=https' --proto-redir '=https' --tlsv1.2 \
--fail --location --silent --show-error \
--retry 3 --retry-connrefused \
--output openlogi-install.sh \
https://raw.githubusercontent.com/AprilNEA/OpenLogi/master/packaging/linux/install.sh
less openlogi-install.sh
sh openlogi-install.sh
rm openlogi-install.sh安装程序默认选择最新发行版。它检测处理器架构以及 apt、dnf、yum、zypper、rpm 或 pacman。在通过 sudo 调用包管理器前,它会验证分离的 minisign 签名与精确的 SHA256SUMS 条目。
| 选项 | 作用 |
|---|---|
--version 0.8.15 | 安装指定发行版。安装程序也接受前缀 v。 |
--package-manager zypper | 覆盖自动检测的包管理器。 |
--no-start | 安装软件包,但不启用或启动用户代理。 |
--dry-run | 下载并验证软件包,但不安装或启动代理。 |
如果系统提供 systemd,安装程序会为当前用户启用并启动 openlogi-agent.service。用户服务无法启动不会回滚已成功完成的软件包安装。
手动安装软件包
从最新发行版下载匹配的软件包,然后使用对应的包管理器:
# Debian / Ubuntu
sudo dpkg -i openlogi-*.deb
# Fedora / RHEL
sudo rpm -i openlogi-*.rpm
# Arch Linux
sudo pacman -U openlogi-*.pkg.tar.zst手动安装软件包后,为当前用户启用代理:
systemctl --user enable --now openlogi-agent.service发行版软件包会安装 udev 规则。规则无需 sudo 即可授予 /dev/uinput 写入权限、/dev/hidraw* 读写权限,以及 Logitech 鼠标 /dev/input/event* 节点的读取权限。
如果安装规则后访问仍被拒绝,请拔下并重新连接接收器或鼠标。GUI 的设置(Settings)→ 权限(Permissions)页面会显示实时访问状态。
Flatpak 捆绑包
每个发行版都提供 amd64 和 arm64 的 Flatpak 捆绑包:
flatpak install --user ./openlogi-*.flatpak捆绑包没有远程仓库,因此 flatpak update 没有可检查的内容。新版本发布后,下载下一个捆绑包。
Flatpak 无法写入主机 udev 规则。OpenLogi 检测设备前,必须在主机上安装捆绑包内的规则:
flatpak run --command=cat org.openlogi.OpenLogi \
/app/share/openlogi/udev/70-openlogi.rules | \
sudo tee /etc/udev/rules.d/70-openlogi.rules >/dev/null
sudo udevadm control --reload-rules
sudo udevadm trigger授予访问权限后,重启 Flatpak:
flatpak kill org.openlogi.OpenLogiFlatpak 自行启动代理,因此无需启用用户服务。其 udev 规则在启动时创建 /dev/uinput,并在 OpenLogi 打开该节点时加载模块。
NixOS
使用仓库的 NixOS 模块,而不要只添加软件包。该模块会安装 OpenLogi 及其 udev 规则,并默认随图形会话启动代理。
{
inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
inputs.openlogi = {
url = "github:AprilNEA/OpenLogi";
inputs.nixpkgs.follows = "nixpkgs";
};
outputs = { nixpkgs, openlogi, ... }: {
nixosConfigurations.my-host = nixpkgs.lib.nixosSystem {
system = "x86_64-linux"; # 或 aarch64-linux
modules = [
openlogi.nixosModules.default
{
programs.openlogi = {
enable = true;
launchAtLogin = true;
};
}
];
};
};
}将 programs.openlogi.launchAtLogin 设为 false,即可安装软件包和规则而不在登录时启动代理。随后可以使用 systemctl --user start openlogi-agent.service 启动代理。
其他 Linux 系统
如果从源码构建,请使用稳定版 Rust 工具链。构建 4 个生产二进制文件。然后在仓库检出目录中以普通用户运行源码安装程序:
cargo build --release \
-p openlogi -p openlogi-desktop -p openlogi-overlay -p openlogi-agent
packaging/linux/install.sh --from-source只有需要其他二进制前缀时,才将 --prefix=/usr 与 --from-source 一起使用。在 SysV init 或 OpenRC 上,把捆绑 udev 规则中的 TAG+="uaccess" 替换为 MODE="0660", GROUP="input",将用户加入 input 组,再重新登录:
sudo usermod -aG input "$USER"在 Wayland 上,自动按应用切换配置需要 XWayland。在 Hyprland 或 Omarchy 中,原生操作需要 systemd 用户管理器环境中存在 HYPRLAND_INSTANCE_SIGNATURE 和 XDG_RUNTIME_DIR。
Windows
每个发行版都提供已签名的、按用户安装的 x86_64 与 arm64 .msi 安装程序,以及便携式 .zip 压缩包。MSI 安装到当前用户的本地应用程序文件夹,无需提升权限。
两种格式都会将 OpenLogi.exe 与 openlogi-agent.exe 放在一起。使用便携版 ZIP 时,必须保持这两个文件在同一目录,因为 GUI 通过后台代理进行设备 I/O。
主窗口关闭后,代理会在通知区域显示图标。关闭设置(Settings)→ 通用(General)→ 在通知区域显示(Show in the notification area),然后重启代理即可隐藏它;也可以在 [app_settings] 中设置 show_in_menu_bar = false,再重启代理。
更新
**macOS:**发行版应用包通过 Sparkle 更新,该路径自 v0.8.14 起提供。在设置 → 更新(Updates)中检查、下载并安装更新;Homebrew 安装通过 brew upgrade 更新。
**Linux:**使用安装发行版软件包的包管理器更新。对于 Flatpak,请下载并安装下一个捆绑包,因为 flatpak update 没有远程仓库可查询。
Windows:MSI 支持通过设置 → 更新(Updates)在应用内更新。选择下载并安装(Download & Install),并在更新就绪后重启 OpenLogi。
安装来源
设置(Settings)→ 更新(Updates)→ 安装来源(Installation source)会识别正在运行的副本是 Homebrew cask、Linux 软件包、Nix 安装、Windows MSI、便携版 ZIP 或 macOS 应用包。OpenLogi 没有当前副本的归属证据时显示无法识别(Not identified);只读识别结果不会改变更新行为。
卸载
对于 Linux 发行版软件包,通过安装该软件包的包管理器移除 OpenLogi。对于使用 --from-source 安装的 Linux 源码版本,在检出目录中运行移除脚本;如果使用了自定义前缀,必须传入相同前缀:
packaging/linux/uninstall.sh
# 如果源码安装使用了自定义前缀:
packaging/linux/uninstall.sh --prefix=/usr