⚡️A native, local-first alternative to Logitech Options+, written in Rust 🦀 — remap buttons, DPI, and SmartShift over HID++. No account, no telemetry.

当前项目代码仓暂无内容

自动翻译

Warning

OpenLogi 正在积极开发中，尚不稳定——功能与配置可能仍会变化。为仓库点一个 Star ⭐ 并 Watch 👀，以便在新版本发布时收到通知。

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

OpenLogi

⚡️ 一款原生、本地优先的 Logitech Options+ 替代方案，使用 Rust 🦀 编写
通过 HID++ 和 UVC 释放 Logitech 鼠标、键盘和网络摄像头的完整功能

受够 Options+ 了？试试 OpenLogi。

适用于 macOS、Linux 和 Windows。

超越 Options+

以下 OpenLogi 可以做到，而 Options+ 无法做到：

保持轻量。 原生 Rust + GPUI。
可在 Linux 上运行。 在 OpenLogi 中，Linux 是一等公民平台。
任意按键支持手势。 将手势功能赋予任意物理按键——或完全关闭手势。
纯文本配置。 所有设置都保存在一个 TOML 文件中，你可以按任意方式在多台设备之间同步。
可脚本化。 提供与 GUI 配套的真实 CLI。

功能

通过 Logi Bolt 接收器、Unifying 接收器、蓝牙或有线连接接入的设备，并显示电池电量和充电状态
通过操作系统输入钩子进行按键重映射：内置动作目录，以及可在 TOML 配置中编写的自定义键盘快捷键，包括独立的短按 / 长按动作，以及用于按压说话的按住至释放组合键¹
按应用的配置覆盖层，会在应用获得焦点时自动切换（macOS + Windows；Linux 仅限 X11 / XWayland）
Litra 灯光：电源、亮度和色温，可选自动电源，会根据摄像头活动自动开启

鼠标

捕获并重映射中键、模式切换键和拇指滚轮键（中键普遍可用，其余按键取决于设备是否支持）
可在任意支持手势的按键上，按方向绑定手势，并支持实时捕获
Actions Ring：以光标为中心、包含八个动作槽位的浮层（ShowActionsRing），支持按应用设置布局
支持预设的 DPI 控制，以及 Cycle / Set-preset 动作（0x2201）
SmartShift 滚轮：模式切换、灵敏度，以及永久棘轮面板（0x2111）
按设备原生翻转滚动方向（0x2121，受支持的设备）

键盘

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

摄像头

任意 Logitech UVC 摄像头（Brio、StreamCam、C920 系列……），即插即用
实时预览只在你观看时打开摄像头——离开后完全释放摄像头，指示灯熄灭
图像控制直接写入 UVC 硬件——变焦、对焦、曝光、亮度、对比度、饱和度、清晰度、白平衡、色调、防闪烁和低光照补偿，并支持对焦 / 曝光 / 白平衡的自动模式开关——因此更改可在 Meet / Zoom / OBS 以及所有其他使用摄像头的应用中生效
一键配置：内置 Default / Streaming / Video call，外加自定义快照；设置按摄像头持久保存，并在下次预览时写回硬件

¹ 在 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 的软件包。预构建软件包需要 GLIBC 2.35 或更高版本（Ubuntu 22.04 基线）。

NixOS 用户也可以导入该仓库的模块，该模块会安装软件包和 udev 规则，并随图形会话启动 agent：

{
  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"; # or aarch64-linux
      modules = [
        openlogi.nixosModules.default
        { programs.openlogi.enable = true; }
      ];
    };
  };
}

所有 Linux 软件包都会安装 udev 规则，让你的用户无需 sudo 即可访问 /dev/hidraw*、/dev/uinput 以及你的 Logitech 鼠标的 /dev/input/event* 节点。NixOS 模块会自动启动 agent；安装 .deb、.rpm 或 .pkg.tar.zst 后，请为你的用户启用它：

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

完整的 NixOS 选项、手动 / 源码安装，以及无 systemd 的发行版，请参阅 docs/INSTALL-linux.md。

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。