[!WARNING] OpenLogi 正在积极开发中，尚未稳定——功能和配置可能仍会变化。给仓库点个 Star ⭐ 并 Watch 👀，新版本发布时你会收到通知。

English | 简体中文 | 日本語 | Deutsch | Français | 한국어

OpenLogi

⚡️ 用 Rust 编写的 Logitech Options+ 原生本地替代品 🦀
通过 HID++ 和 UVC 解锁罗技鼠标、键盘和网络摄像头的全部功能

受够 Options+ 了？试试 OpenLogi。

支持 macOS、Linux 和 Windows。

超越 Options+

OpenLogi 能做到而 Options+ 做不到的事：

保持轻量。 原生 Rust + GPUI。
支持 Linux。 Linux 在 OpenLogi 中是一等平台。
任意按键支持手势。 将手势角色赋予任意物理按键——或完全关闭手势。
纯文本配置。 所有配置就是一个 TOML 文件，你可以用任意方式在多台机器间同步。
可脚本化。 除 GUI 外还有真正的 CLI。

功能

通过 Logi Bolt 接收器、Unifying 接收器、蓝牙或有线连接设备，支持电池百分比和充电状态显示
通过操作系统输入钩子进行按键重映射：内置操作目录，以及在 TOML 配置¹中自定义键盘快捷键
按应用配置的配置文件覆盖，可在应用聚焦时自动切换（macOS + Windows；Linux 仅限 X11 / XWayland）
Litra 灯：电源、亮度和色温，可选跟随摄像头活动自动开关

鼠标

捕获并重映射中键、模式切换键和拇指滚轮（中键在所有设备上可用，其余取决于设备是否暴露）
任意支持手势的按键上，支持带实时捕获的按方向手势绑定
操作环：以光标为中心、八个槽位的操作覆盖层（ShowActionsRing），支持按应用布局
DPI 控制，支持预设和循环 / 设置预设操作（0x2201）
SmartShift 滚轮：模式切换、灵敏度，以及永久棘轮面板（0x2111）
每设备原生滚动方向反转（0x2121，支持的设备）

键盘

全局 F 键重映射：与鼠标相同的操作目录，另加高级用户操作——输入文本、组合键、多步骤工作流（macOS + Windows）
静态 RGB 灯效（0x8070 / 0x8080，支持的设备）

摄像头

任何罗技 UVC 网络摄像头（Brio、StreamCam、C920 系列等），即插即用
实时预览仅在观看时打开摄像头——离开后完全释放摄像头，LED 熄灭
图像控制直接写入 UVC 硬件——缩放、对焦、曝光、亮度、对比度、饱和度、清晰度、白平衡、色调，以及自动模式开关（对焦 / 曝光 / 白平衡）——因此更改在 Meet / Zoom / OBS 及所有其他使用摄像头的应用中生效
一键配置：内置默认 / 直播 / 视频通话，以及自定义快照；设置按摄像头持久化，并在下次查看时写回硬件

¹ 媒体键操作在 Linux 上使用 D-Bus MPRIS；少数 macOS 专属操作没有通用的 Linux 等价实现，会被忽略。Windows 在可用时将平台操作映射到原生等价操作。

安装

[!IMPORTANT] 先退出 Logi Options+：两者会争夺 HID++ 访问权，同一接收器只能由一个应用独占。

macOS

要求 macOS 13 或更高版本。

从最新发布下载已签名、已公证的 .dmg，将 OpenLogi.app 拖到 /Applications。

或通过 Homebrew 安装：

brew install --cask openlogi

官方 Homebrew cask 是默认安装路径。要明确跟踪 aprilnea/tap 中的最新 GitHub 发布：

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

openlogi@latest 由 OpenLogi 的发布工作流维护，可能比官方 cask 自动更新更早。请选择安装 openlogi 或 openlogi@latest 之一，不要同时安装。

Linux

从最新发布下载对应发行版的包：

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

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

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

包同时提供 x86_64/amd64 和 arm64/aarch64 架构。

NixOS 用户可以直接导入仓库的模块，该模块会安装软件包和 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; }
      ];
    };
  };
}

所有 Linux 包都会安装 udev 规则，赋予你的用户访问 /dev/hidraw*、/dev/uinput 和你的罗技鼠标的 /dev/input/event* 节点的权限，无需 sudo。NixOS 模块会自动启动代理；安装 .deb、.rpm 或 .pkg.tar.zst 后，为你的用户启用它：

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

查看 docs/INSTALL-linux.md 获取完整的 NixOS 选项、手动 / 源码安装，以及无 systemd 的发行版说明。

Windows

每个发布版本都附带签名便携式 .zip 存档和每用户 .msi 安装程序（x86_64 和 arm64）。两者都随附 GUI（OpenLogi.exe）和后台代理（openlogi-agent.exe），代理负责所有设备 I/O。使用便携版 zip 时请将这两个文件放在一起，否则 GUI 将无连接对象。

Windows 支持已在 Windows 11 上使用真实硬件（有线键盘和 Unifying 接收器鼠标）进行了端到端验证，包括 MSI 的安装、就地升级和卸载。它比 macOS 版本更新，因此如果遇到问题，请报告。代理会在系统托盘显示图标（显示主窗口 / 退出），以便关闭主窗口后应用仍可访问。要在 Windows 上禁用它，请在 TOML 的 [app_settings] 块中设置 show_in_menu_bar = false 并重启代理；GUI 切换目前仅限 macOS。

要从源码构建，请参阅 DEVELOPMENT.md。