Skip to content

Latest commit

 

History

History
169 lines (111 loc) · 11.2 KB

File metadata and controls

169 lines (111 loc) · 11.2 KB

Warning

OpenLogi は現在活発に開発中であり、まだ安定していません —— 機能や設定は今後も変わる可能性があります。リポジトリに Star ⭐ と Watch 👀 を付けて、リリースが出た瞬間に通知を受け取りましょう。

OpenLogi

OpenLogi

⚡️ Rust 製のネイティブでローカルファーストな Logitech Options+ 代替 🦀
HID++ でボタン・DPI・SmartShift を再マッピング。アカウント不要、テレメトリなし。

AprilNEA%2FOpenLogi | Trendshift

Options+ にうんざり?OpenLogi をどうぞ。

Logitech アカウントもテレメトリも公式 Options+ のインストールも不要で、ボタンの再マッピング、DPI と SmartShift の制御、アプリごとのプロファイル切り替えができます。クラウドなし、設定はプレーンな TOML ファイル。ネットワーク通信はデバイス画像の取得と、デフォルトオフのオプトイン更新チェックだけです。


概要

OpenLogi は Logi Bolt レシーバー経由 —— あるいは Bluetooth 直結 / 有線接続 —— で Logitech の HID++ マウスと通信します。Logi Options+ を動かす必要はありません。2 つのバイナリを提供します:

  • OpenLogi GUI —— GPUI 製デスクトップアプリ:クリック可能なホットスポット付きのインタラクティブなマウス図、ボタンごとのアクションピッカー(41 種の組み込みアクション + TOML 設定に手書きするカスタムショートカット)、DPI プリセット、SmartShift パネル(ホイールモード・感度・永続ラチェット)、アプリごとのプロファイルオーバーレイ、ペアリング済みデバイスをライブで切り替えるデバイスカルーセル、そして 20 言語にローカライズされた設定ウィンドウ。
  • OpenLogi CLI —— ヘッドレスなデバイス一覧(list)、アセット同期、デバイス診断のサブコマンドを備えた CLI。

すべてはローカルで完結します:バインディングはプレーンな TOML ファイルに保存され、ボタン入力は OS のイベントフックで再マッピングされ、DPI / SmartShift の変更は HID++ で直接デバイスに書き込まれます。

macOS と Linux をサポートしています。Windows は未検証の早期プレビューで、各リリースに署名済みビルドが付属します —— ロードマップを参照。

Options+ を超えて

OpenLogi にできて Options+ にできないこと:

  • Linux で動く。 Options+ は macOS と Windows のみ。OpenLogi は Linux をファーストクラスで扱います:evdev/uinput フック、udev ルール、systemd ユーザーユニット、.deb / .rpm パッケージ。
  • ジェスチャーボタンを移せる。 どの物理ボタンがジェスチャー役を担うか —— サムパッド、ミドル、戻る、進む —— を選べ、方向ごとのスワイプバインディングを設定でき、ジェスチャーを完全にオフにもできます。Options+ はジェスチャーを専用サムパッドに固定しています。
  • 設定がプレーンテキスト。 すべてが 1 つの TOML ファイル。読めて、diff できて、バージョン管理に入れられて、マシン間でコピーできます。
  • スクリプトで叩ける。 本物の CLI:デバイス一覧、アセットのプリフェッチ、デバイス上での HID++ 診断(フィーチャーダンプ、DPI / SmartShift のラウンドトリップ検査)。
  • 軽量なまま。 ネイティブ Rust + GPUI バイナリ —— Electron スイートも常駐アップデーターもアカウントもテレメトリもなし。

ロードマップ

機能 状態
Bolt レシーバーの発見 + ペアリング済みデバイスの一覧(CLI + GUI)
Unifying レシーバー(Bolt に置き換えられた旧プロトコル)
Bluetooth 直結 / 有線デバイス(レシーバーなし)
バッテリー残量 / 充電状態 ✅(オンラインのデバイス)
インタラクティブ GUI:カルーセル、マウス図、アクションピッカー ✅ macOS + Linux
OS イベントフック / evdev によるボタン再マッピング ✅ macOS + Linux
41 アクションのカタログ + カスタムキーボードショートカット(TOML 手書き) ✅ macOS + Linux¹
DPI 制御 + プリセット + サイクル / プリセット指定アクション(HID++ 0x2201
SmartShift ホイール:モード切替 + 感度 + 永続ラチェットパネル(HID++ 0x2111
アプリごとのプロファイルオーバーレイ(フォーカスで自動切替) ✅ macOS、🟡 Linux(X11 のみ)
設定ウィンドウ:ログイン時起動、更新チェック、メニューバー、権限、言語 ✅ macOS + Linux
UI のローカライズ(20 言語:da、de、el、en、es、fi、fr、it、ja、ko、nb、nl、pl、pt-BR、pt-PT、ru、sv、zh-CN、zh-HK、zh-TW)
Linux パッケージング:udev ルール、systemd ユニット、.deb / .rpm ✅ Linux
ジェスチャーボタンの方向別バインディング 🟡 設定可能;ハードウェアキャプチャは開発中
ミドル / モードシフト / サムホイールボタンのキャプチャ 🟡 設定可能;フックが扱うのは現状サイドボタンのみ
Windows(agent、GUI、イベントフック) 🟡 未検証プレビュー —— 各リリースに署名済み .exe / .msi が付属

¹ Linux のメディアキーアクションは D-Bus MPRIS を使います。macOS 固有の一部アクション(Launchpad など)は Linux に対応物がなく、no-op になります。

インストール

Important

先に Logi Options+ を終了してください —— 両者は HID++ アクセスを奪い合い、1 つのレシーバーを同時に所有できるのは片方だけです。

macOS

最新リリースから署名・公証済みの .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 の autobump より先に更新されることがあります。openlogiopenlogi@latest のどちらか一方だけをインストールしてください。

Linux

最新リリースから .deb または .rpm をダウンロード:

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

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

パッケージは x86_64/amd64arm64/aarch64 の両方で公開されています。

パッケージは udev ルールをインストールし、sudo なしで /dev/hidraw*/dev/uinput にアクセスできるようにします。インストール後、ユーザーのバックグラウンドエージェントを有効化してください:

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

手動 / ソースからのインストールや systemd のないディストリビューションは INSTALL-linux.md を参照。

Windows(プレビュー)

各リリースに署名済み .exe とユーザー単位の .msi インストーラー(x86_64 と arm64)が付属します。Windows サポートは実機での検証がまだ十分でない早期プレビューです —— 粗削りな部分はご容赦のうえ、issue で報告してください。

ソースからのビルドは DEVELOPMENT.md を参照。

使い方(CLI)

USAGE.md を参照

設定

CONFIGURATION.md を参照

開発

DEVELOPMENT.md を参照

謝辞

ライセンス

以下のいずれかを選択できます:

ロゴとブランドアセット

OpenLogi のロゴとアプリアイコン —— design/ 配下のブランドアセット —— は © 2026 AprilNEA が全権利を留保しており、上記の MIT/Apache ライセンスの対象外です。design/LICENSE を参照してください。コードをフォークしても OpenLogi の名称・ロゴ・アイコンの使用権は付与されません。事前の書面による許可なく、ご自身のプロジェクト、フォーク、配布物を表すために使用しないでください。


Logitech とは無関係です。 「Logitech」「MX Master」「Options+」は Logitech International S.A. の商標です。

リポジトリの活動

Repobeats analytics image