[!CẢNH BÁO] OpenLogi đang được phát triển tích cực và chưa ổn định — các tính năng và cấu hình vẫn có thể thay đổi. Cung cấp cho repo một Ngôi sao ⭐ và Xem 👀 nó để nhận được thông báo khi có bản phát hành mới.

Tiếng Anh | 简体中文 | 日本語 | tiếng Đức | người Pháp | 한국어

OpenLogi

⚡️ Giải pháp thay thế gốc, ưu tiên cục bộ cho Logitech Options+, được viết bằng Rust 🦀
Khám phá toàn bộ khả năng của chuột, bàn phím và webcam Logitech qua HID++ và UVC

Chán ngấy với Tùy chọn +? Hãy thử OpenLogi.

Chạy trên macOS, Linux và Windows.

---

Ngoài các lựa chọn+

Những điều OpenLogi thực hiện mà Tùy chọn+ sẽ không:

• Giữ ánh sáng. Bản địa Rust + GPUI.
• Chạy trên Linux. Linux là nền tảng hạng nhất trong OpenLogi.
• Cử chỉ trên bất kỳ nút nào. Cung cấp vai trò cử chỉ cho bất kỳ nút vật lý nào - hoặc tắt hoàn toàn cử chỉ.
• Cấu hình văn bản thuần túy. Mọi thứ đều là một tệp TOML mà bạn có thể đồng bộ hóa giữa các máy theo cách bạn muốn.
• Viết kịch bản nó. Một CLI thực sự cùng với GUI.

Tính năng

• Các thiết bị được kết nối qua bộ thu Logi Bolt, bộ thu Unifying, Bluetooth hoặc kết nối có dây, có phần trăm pin và trạng thái sạc
• Ánh xạ lại nút thông qua hook đầu vào của hệ điều hành: danh mục hành động tích hợp cùng với các phím tắt tùy chỉnh được tạo trong cấu hình TOML¹
• Lớp phủ hồ sơ trên mỗi ứng dụng tự động chuyển trọng tâm ứng dụng (chỉ macOS + Windows; Linux trên X11 / XWayland)
• Đèn Litra: công suất, độ sáng và nhiệt độ màu, với nguồn tự động tùy chọn theo hoạt động của máy ảnh

Chuột

• Chụp và sắp xếp lại các nút ở giữa, chuyển chế độ và nút xoay ngón tay cái (ở giữa mọi nơi, phần còn lại nơi thiết bị hiển thị chúng)
• Liên kết cử chỉ theo hướng với tính năng chụp trực tiếp, trên bất kỳ nút nào có khả năng
• Vòng hành động: lớp phủ hành động gồm tám vị trí, tập trung vào Cursor (ShowActionsRing), với bố cục cho mỗi ứng dụng
• Kiểm soát DPI với các cài đặt trước và các hành động Chu kỳ / Đặt trước (0x2201)
• Bánh xe SmartShift: chuyển đổi chế độ, độ nhạy và bảng bánh cóc cố định (0x2111)
• Đảo ngược cuộn gốc trên mỗi thiết bị (0x2121, thiết bị được hỗ trợ)

Bàn phím

• Ánh xạ lại phím F toàn cầu: danh mục hành động giống như chuột, cộng với các hành động của người dùng thành thạo - văn bản đã nhập, tổ hợp phím, quy trình làm việc nhiều bước (macOS + Windows)
• Ánh sáng RGB tĩnh (0x8070 / 0x8080, thiết bị được hỗ trợ)

Máy ảnh

• Bất kỳ webcam Logitech UVC nào (Brio, StreamCam, dòng C920,…), cắm và chạy
• Xem trước trực tiếp chỉ mở camera trong khi bạn xem — để nó nhả hoàn toàn camera và đèn LED tắt
• Các điều khiển hình ảnh được ghi thẳng vào phần cứng UVC — thu phóng, lấy nét, phơi sáng, độ sáng, độ tương phản, độ bão hòa, độ sắc nét, cân bằng trắng, tông màu, chống nhấp nháy và bù ánh sáng yếu, với các nút chuyển đổi chế độ tự động để lấy nét/phơi sáng/cân bằng trắng — vì vậy, các thay đổi sẽ được áp dụng trong Meet/Zoom/OBS và mọi ứng dụng khác sử dụng máy ảnh
• Cấu hình bằng một cú nhấp chuột: Cuộc gọi mặc định / Truyền phát / Video tích hợp sẵn cộng với ảnh chụp nhanh tùy chỉnh; cài đặt vẫn tồn tại trên mỗi camera và được ghi lại vào phần cứng ở chế độ xem tiếp theo

¹ Các tác vụ chính của phương tiện sử dụng D-Bus MPRIS trên Linux; một số hành động dành riêng cho macOS không có hành động tương đương với Linux phổ biến và không hoạt động. Windows ánh xạ các hành động nền tảng tới các hành động gốc tương đương nếu có.

cài đặt

[!QUAN TRỌNG] Thoát Tùy chọn đăng nhập+ đầu tiên: hai ứng dụng tranh giành quyền truy cập HID++ và mỗi lần chỉ một ứng dụng có thể sở hữu một bộ thu nhất định.

macOS

Yêu cầu macOS 13 trở lên.

Tải bản đã ký, công chứng .dmg từ bản phát hành mới nhất và kéo OpenLogi.app để /Applications.

Hoặc cài đặt qua Homebrew:

brew install --cask openlogi

Thùng Homebrew chính thức là đường dẫn cài đặt mặc định. Để theo dõi rõ ràng bản phát hành GitHub mới nhất từ ​​ aprilnea/tap thay vào đó:

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

openlogi@latest được duy trì bởi quy trình phát hành của OpenLogi và có thể cập nhật trước khi thùng tự động cập nhật chính thức. Cài đặt một trong hai openlogi hoặc openlogi@latest, không phải cả hai.

Linux

Tải xuống gói phân phối của bạn từ bản phát hành mới nhất:

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

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

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

Các gói được xuất bản cho cả hai x86_64/amd64 và arm64/aarch64. Các gói dựng sẵn yêu cầu GLIBC 2.35 hoặc mới hơn (cơ sở Ubuntu 22.04).

Thay vào đó, người dùng NixOS có thể nhập mô-đun của kho lưu trữ để cài đặt gói và quy tắc udev, đồng thời khởi động tác nhân bằng phiên đồ họa:

{
  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; }
      ];
    };
  };
}

Tất cả các gói Linux đều cài đặt các quy tắc udev cấp cho người dùng của bạn quyền truy cập vào /dev/hidraw*, /dev/uinput và chuột Logitech của bạn /dev/input/event* nút không có sudo. Mô-đun NixOS tự động khởi động tác nhân; sau một .deb, .rpmhoặc .pkg.tar.zst cài đặt, kích hoạt nó cho người dùng của bạn:

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

Xem tài liệu/CÀI ĐẶT-linux.md để biết các tùy chọn NixOS hoàn chỉnh, cài đặt thủ công/nguồn và các bản phân phối không có systemd.

cửa sổ

Ký xách tay .zip kho lưu trữ và mỗi người dùng .msi trình cài đặt (x86_64 và arm64) được đính kèm vào mỗi bản phát hành. Cả hai đều gửi GUI (OpenLogi.exe) cùng với tác nhân nền (openlogi-agent.exe), sở hữu tất cả I/O của thiết bị. Giữ hai tệp cạnh nhau khi sử dụng zip di động hoặc GUI không có gì để kết nối.

Hỗ trợ Windows đã được xác thực toàn diện trên Windows 11 bằng phần cứng thực (bàn phím có dây và chuột thu Unifying), bao gồm cài đặt, nâng cấp tại chỗ và gỡ cài đặt MSI. Nó mới hơn bản dựng macOS, vì vậy nếu bạn gặp khó khăn, vui lòng báo cáo nó. Tác nhân hiển thị biểu tượng khay hệ thống (Hiển thị cửa sổ chính / Thoát) để ứng dụng vẫn có thể truy cập được sau khi đóng cửa sổ chính. Để tắt nó trên Windows, hãy đặt show_in_menu_bar = false trong TOML [app_settings] chặn và khởi động lại đại lý; chuyển đổi GUI hiện chỉ dành cho macOS.

Để xây dựng từ nguồn, xem PHÁT TRIỂN.md.

Cách sử dụng (CLI)

Xem SỬ DỤNG.md

Cấu hình

Xem CẤU HÌNH.md

Đang phát triển

Xem PHÁT TRIỂN.md

Lời cảm ơn

• Windows, máy ảnh và i18n bởi @davidbudnick - bàn phím RGB, hỗ trợ Windows, hỗ trợ webcam Logitech
• Cổng Linux bởi @cserby - Hỗ trợ Linux
• tắm nắng bởi @pwr - triển khai HID++ mã nguồn mở
• Người bắt chuột bởi @TomBadash — một lựa chọn thay thế cục bộ, không cần tài khoản

Giấy phép

Mã trong kho lưu trữ này được cấp phép kép theo một trong hai

• Giấy phép Apache, Phiên bản 2.0 (GIẤY PHÉP-APACHE)
• Giấy phép MIT (GIẤY PHÉP-MIT)

theo lựa chọn của bạn.

Mã của bên thứ ba

crates/openlogi-hidpp là một nhánh fork được bán của hidpp bởi @lus, được cấp phép 0BSD.

Logo và tài sản thương hiệu

Nhờ có @kubai087 để thiết kế logo OpenLogi. Logo OpenLogi và biểu tượng ứng dụng (tài sản thương hiệu dưới design/) là © 2026 AprilNEA, mọi quyền được bảo lưu và không thuộc phạm vi điều chỉnh của giấy phép MIT/Apache ở trên; nhìn thấy design/LICENSE. Việc phân tách mã sẽ không cấp quyền đối với tên, logo hoặc biểu tượng OpenLogi; vui lòng không sử dụng chúng để đại diện cho các dự án, nhánh hoặc bản phân phối của riêng bạn mà không có sự cho phép trước bằng văn bản.

---

Không liên kết với Logitech. "Logitech", "MX Master" và "Options+" là các nhãn hiệu của Logitech International S.A.

Hoạt động repo