Skip to content

README.ru.md

Latest commit

 

History

History
228 lines (162 loc) · 14.7 KB

README.ru.md

File metadata and controls

228 lines (162 loc) · 14.7 KB
Raw

Warning

OpenLogi активно разрабатывается и ещё не стабилен — функции и конфигурация могут меняться. Поставьте репозиторию Star ⭐ и Watch 👀, чтобы узнать о новом релизе.

English | 简体中文 | 日本語 | Deutsch | Français | 한국어 | Русский | Español | Português | Türkçe

OpenLogi

OpenLogi

⚡️ Нативная local-first альтернатива Logitech Options+, написанная на Rust 🦀
Полные возможности мышей, клавиатур и веб-камер Logitech по HID++ и UVC

AprilNEA%2FOpenLogi | Trendshift OpenLogi - A local-first alternative to Logitech Options+ | Product Hunt

Надоел Options+? Попробуйте OpenLogi.

Работает на macOS, Linux и Windows.

Больше, чем Options+

То, что OpenLogi умеет, а Options+ — нет:

  • Лёгкий. Нативный Rust + GPUI.
  • Linux. Linux — платформа первого класса.
  • Жесты на поддерживаемых кнопках. Назначайте действия жестам на поддерживаемых элементах управления — или отключите жесты совсем.
  • Конфиг обычным текстом. Всё в одном TOML-файле, который можно синхронизировать между машинами как угодно.
  • Скрипты. Настоящий CLI рядом с GUI.

Возможности

  • Устройства через приёмники Logi Bolt, Unifying, Bluetooth или провод, с процентом батареи и состоянием зарядки
  • Переназначение кнопок через OS input hook: встроенный каталог действий плюс свои сочетания клавиш в TOML, включая независимые действия на короткое/длинное нажатие и аккорды hold-until-release для push-to-talk¹
  • Оверлеи профилей по приложениям с автопереключением по фокусу (macOS + Windows; Linux только на X11 / XWayland)
  • Подсветка Litra: питание, яркость и цветовая температура, опционально автопитание по активности камеры

Мышь

  • Захват и переназначение средней кнопки, mode-shift и thumbwheel (средняя везде, остальные — где устройство их отдаёт)
  • Жесты по направлениям с live capture на поддерживаемых элементах управления: Назад/Вперёд, DPI/ModeShift, выделенной кнопке жестов и тактильной панели
    • Для жестов DPI/ModeShift устройство должно сообщать о поддержке перенаправления событий (diversion) и raw-XY.
    • Левой и правой кнопкам и элементам управления колёсами нельзя назначать новые жесты; существующие жесты средней кнопки сохраняются.
  • Actions Ring: оверлей из восьми слотов вокруг курсора (ShowActionsRing), с раскладками по приложениям
  • DPI: пресеты и действия Cycle / Set-preset (0x2201)
  • Колесо SmartShift: переключение режима, чувствительность и панель постоянного храповика (0x2111)
  • Нативная инверсия прокрутки на устройство (0x2121, поддерживаемые устройства)

Клавиатура

  • Глобальное переназначение F-клавиш: тот же каталог действий, что у мыши, плюс действия для продвинутых пользователей — набор текста, комбинации клавиш, многошаговые сценарии (macOS + Windows)
  • Статическая RGB-подсветка (0x8070 / 0x8080, поддерживаемые устройства)

Камера

  • Любая Logitech UVC-веб-камера (Brio, StreamCam, серия C920, …), plug and play
  • Живой превью открывает камеру только пока вы смотрите — выход полностью освобождает камеру, LED гаснет
  • Настройки изображения пишутся сразу в UVC-железо — zoom, focus, exposure, brightness, contrast, saturation, sharpness, white balance, tint, anti-flicker и low-light compensation, с авто-режимами focus / exposure / white balance — поэтому изменения видны в Meet / Zoom / OBS и любом другом приложении, использующем камеру
  • Профили в один клик: встроенные Default / Streaming / Video call плюс свои снимки; настройки хранятся на камеру и записываются обратно в железо при следующем просмотре

¹ Действия медиаклавиш на Linux идут через D-Bus MPRIS; часть macOS-специфичных действий не имеет универсального Linux-аналога и становится no-op. Windows сопоставляет платформенные действия с нативными эквивалентами, где это возможно.

Установка

Important

Сначала закройте Logi Options+: два приложения борются за доступ к HID++, и приёмник может принадлежать только одному из них.

macOS

Нужен macOS 13 или новее.

Скачайте подписанный и нотаризованный .dmg из последнего релиза и перетащите OpenLogi.app в /Applications.

Или установите через Homebrew:

brew install --cask openlogi

Официальный cask Homebrew — путь установки по умолчанию. Чтобы явно следить за последним GitHub-релизом из aprilnea/tap:

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

openlogi@latest поддерживается workflow релизов OpenLogi и может обновиться раньше официального autobump 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 и запускает агент вместе с графической сессией:

{
  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, которые дают вашему пользователю доступ к /dev/hidraw*, /dev/uinput и узлу /dev/input/event* мыши Logitech без sudo. Модуль NixOS запускает агент сам; после установки .deb, .rpm или .pkg.tar.zst включите его для своего пользователя:

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

Полные опции NixOS, ручная / source-установка и дистрибутивы без systemd — в INSTALL-linux.md.

Windows

К каждому релизу прилагаются подписанные портативные .zip и пользовательские установщики .msi (x86_64 и arm64). И то и другое включает GUI (OpenLogi.exe) и фоновый агент (openlogi-agent.exe), который владеет всем I/O устройств. В портативном zip держите оба файла рядом, иначе GUI не к чему подключаться.

Поддержка Windows проверена end-to-end на Windows 11 с живым железом (проводная клавиатура и мышь на Unifying-приёмнике), включая установку, in-place обновление и удаление MSI. Сборка новее macOS, поэтому если натолкнётесь на шероховатость — сообщите. Агент показывает иконку в системном трее (Show Main Window / Quit), чтобы приложение оставалось доступным после закрытия главного окна. Чтобы отключить её на Windows, задайте show_in_menu_bar = false в блоке TOML [app_settings] и перезапустите агент; переключатель в GUI пока только на macOS.

Сборка из исходников: DEVELOPMENT.md.

Использование (CLI)

См. USAGE.md

Конфигурация

См. CONFIGURATION.md

Разработка

См. DEVELOPMENT.md

Благодарности

  • Windows, камеры и i18n — @davidbudnick: RGB клавиатуры, поддержка Windows, веб-камеры Logitech
  • Порт на Linux — @cserby
  • Solaar от @pwr — открытая реализация HID++
  • Mouser от @TomBadash — локальная замена Options+ без аккаунта

Лицензия

Код в этом репозитории распространяется по двойной лицензии — на выбор:

Сторонний код

crates/openlogi-hidpp — вендорский форк hidpp от @lus, лицензия 0BSD.

Логотип и бренд

Спасибо @kubai087 за дизайн логотипа OpenLogi. Логотип и иконка приложения (бренд-ассеты в design/) © 2026 AprilNEA, все права защищены, и не покрываются лицензиями MIT/Apache выше; см. design/LICENSE. Форк кода не даёт прав на имя, логотип или иконку OpenLogi; не используйте их для своих проектов, форков и дистрибутивов без предварительного письменного разрешения.

Не связан с Logitech. «Logitech», «MX Master» и «Options+» — товарные знаки Logitech International S.A.

Активность репозитория

Repobeats analytics image