Logitech
G915 TKL(LIGHTSPEED レシーバー)
固定色、ブリージング、スペクトラム、消灯。キーエディターによるキーごとの色。ファームウェアのウェーブとリップルのエフェクト。バッテリー。
すべての RGB ライティングを、小さなトレイアプリ 1 つで。
RGB Tray は、キーボード、マウス、ライトを HID で直接、Tuya 電球をローカルネットワーク経由で制御します。色、エフェクト、明るさを全デバイス一括またはデバイスごとに設定でき、メーカー製ソフトウェアをバックグラウンドで動かす必要はありません。
代わりに G HUB Synapse Armoury Crate SignalRGB
01
ブランドごとに専用のライティングアプリがあり、どれもバックグラウンドで動こうとします。RGB Tray は、そのライティング部分をまとめて 1 つで担います。
各デバイスのプロトコルを自分で話すため、G HUB、Synapse、Armoury Crate、SignalRGB を動かしておく必要はありません。インストールに管理者権限は不要です。
トレイアイコンを左クリックするとパネルが開きます。色、エフェクト、明るさを全デバイス一括またはデバイスごとに設定でき、グローバルホットキーに割り当てられるプリセットもあります。
スリープ(モダン スタンバイを含む)からの復帰時やデバイスの接続時にライティングが戻り、画面に合わせて暗くなり、画面がオフの間は消灯します。
02
現在は 6 つのファミリーに対応しています。同じプロトコルを使う他のモデルも動作する可能性があり、新しいモデルは小さなテキストファイルで追加できることがよくあります。
G915 TKL(LIGHTSPEED レシーバー)
固定色、ブリージング、スペクトラム、消灯。キーエディターによるキーごとの色。ファームウェアのウェーブとリップルのエフェクト。バッテリー。
Naga V2 Pro、Mouse Dock Pro ほか約 90 種
Basilisk、DeathAdder、Viper、Cobra、BlackWidow、Huntsman、Ornata、Firefly、Goliathus、Base Station など、OpenRazer のデータに基づく機種:エフェクト、マウスのゾーン、バッテリー。大半は未検証で、その旨がカードに表示されます。動作報告を歓迎します。
ノート PC のキーボード(Aura)
固定色、ブリージング、スペクトラム、消灯。LampArray によるキーボードのゾーンと本体のランプ。キーボードは復帰時に白へリセットされるため、ライティングを再適用します。
Geekboard MacroPad v2、Keychron、自作キーボード
VIA と RGB に対応した任意の QMK キーボード:固定色、ブリージング、スペクトラム、消灯、明るさ。色は RAM にのみ設定されるため、キーボード自身の保存済み設定には手を加えません。
HID LampArray デバイス
LampArray 規格に対応したデバイス:固定色、ブリージング、スペクトラム、消灯、およびデバイス自身が示すゾーン。ブリージングとスペクトラムはアプリ側で描画します。
Smart Life の Wi-Fi 電球、例:LINUS A60
ローカルネットワーク経由:カラー、色味を調整できる白色、ブリージング、スペクトラム、消灯。電球は画面と連動して消灯しません。電球のローカルキーが必要で、Tuya クラウドから一度取得します。
接続方法、Razer の全モデル、Tuya キーの取得方法は GitHub のデバイス一覧表.
03
小さくても必要十分:本来ならメーカー製アプリを開いて行う操作がそろっています。
全体の明るさに加えて、その上にデバイスごとの明るさを設定可能。ブリージングとスペクトラムの速度も、全体およびデバイスごとに設定できます。
Logitech キーボード用:ブラシ、スポイト、レインボー、2 色グラデーション、WASD のみ・文字キーのみのプリセット、単語のハイライト、スキームの保存、ANSI/ISO 配列。
ライティングを保存し、グローバルホットキーで切り替えられます。Ctrl、Alt、Shift、Win と組み合わせた F13–F24 も使えます。
1 台のデバイスを消灯し、元の状態で再点灯します。たとえば部屋のランプに便利です。プリセットには影響しません。
Windows が画面を暗くするとライティングも暗くなり、画面がオフの間(アイドル、ロック、スリープ)は消灯します。オフにすることもできます。
バッテリー残量の表示、10% と 5% での警告、ワイヤレスデバイスのスリープ中は「No link」(接続なし)と表示。復帰すると色が戻ります。
同じデバイスでもそれぞれ個別に設定でき、シリアル番号で区別されます。切断されたデバイスは設定ごとアーカイブで待機します。
すべての設定をエクスポート/インポートできます。プリセット 1 つをファイルに保存することもでき、受け取った側の同じモデルのデバイスに適用されます。
1 日 1 回 GitHub に最新リリースを問い合わせ、インストールできるカードを表示します。チェックはオフにできます。
トレイアイコンが現在の色を表示し、パネルは最前面にピン留めでき、テーマは Windows に追従し、インターフェースは英語とロシア語です。
05
何かをアンインストールする前に知っておきたい点です。
06
多くのデバイスはコード不要で、小さなプロファイルファイルだけで動きます。Claude Code を使えば、Rust や HID の知識も不要です。技術的な作業は Claude が行い、あなたはライトを見るだけです。
このリポジトリには Claude Code 用の /add-device スキルが付属しています。Claude はデバイスレポートから、テスト済みのプロファイルまたはドライバーまで、ご希望ならプルリクエストまで進めます。
デバイスをつないだ Windows PC で github.com/Gronck2/rgb-tray をクローンし、そのフォルダーで Claude Code を起動します。プロファイルならインストール済みアプリのコマンドラインツールで足ります。ドライバーには Rust が必要で、Claude がインストールを手伝います。
どのデバイスか、どこが光るのかを伝えます。2 つのプログラムがデバイスを奪い合わないよう、先にメーカー製アプリを終了してください。
rgbtray --diagnose を実行し、ベンダー ID とプロダクト ID からデバイスを見つけ、RGB Tray がすでに知っているプロトコルを話すインターフェースがどれかを調べます。
OpenRGB や OpenRazer の中、あなたが記録したメーカー製アプリの USB キャプチャ(手順)、または --hid-send による慎重な試行で探します。試行は 1 回ずつ、あなたの了承を得てからのみです。
プロファイルを書き、--profile-check で確認し、--profile-test で色、ゾーン、エフェクトを再生します。各ステップのあとで、デバイスがどう反応したかを尋ねます。
Claude がプロファイルを %APPDATA%\rgbtray\devices\ にコピーします。RGB Tray を再起動すると、デバイスのカードがパネルに表示されます。そのあと、共有したいかどうかを尋ねます。
Claude にはライトが見えないため、あなたが確認するまで動作したことにはなりません。ファームウェア更新、ブートローダー、工場出荷状態へのリセット、フラッシュへの保存のコマンドは決して送らず、自分で考えたレポートを送る前には必ず確認します。デバイスが応答しなくなったら、いったん抜いて挿し直してください。
Claude と進める場合も手作業の場合も、デバイスには最初に当てはまる方法が使われます。
HID LampArray デバイスと、VIA 対応の QMK キーボードは、汎用ドライバーで制御されます。パネルを開いてカードを探してください。
新しい Razer モデルは、プロダクト ID、トランザクション ID、LED ID を記した小さな TOML ファイルです。値は OpenRazer から取ります。QMK/VIA のプロファイルではファームウェアのエフェクトを指定できます。
[hid] プロファイル単純なプロトコル(色を含むレポートで、応答が不要なもの)は、{r} {g} {b} を使ったレポートテンプレートとして記述します。XOR や合計のチェックサム、「制御を取得」「制御を返す」レポート、LED ごとの色にも対応します。コンパイル不要です。
応答、ハンドシェイク、状態が必要なプロトコルにはドライバーを使います。Device トレイトを実装するモジュールです。手順は CONTRIBUTING.md で説明しています。
プロファイルの作成と確認はアプリ自身で行え、ビルドは不要です。コンソールのない Windows プログラムなので、各ツールは結果を指定したファイルに書き出します。
| コマンド | 動作 |
|---|---|
rgbtray --diagnose report.txt | すべての HID デバイスとインターフェースを一覧にし、RGB Tray が認識するものに印を付け、誤りのあるプロファイルファイルも示します。 |
rgbtray --hid-send out.txt <vid:pid[:page[:usage]]> <feature|output|get> "<hex>" | 生のレポートを送信し、応答をファイルに追記します。プロトコルを解析するためのものです。 |
rgbtray --profile-check out.txt my-device.toml | デバイスに一切触れずにプロファイルを読み込み、各モデルがアプリにどう解釈されるか、または何が間違っているかを書き出します。 |
rgbtray --profile-test out.txt my-device.toml | [hid] プロファイルのデバイスで、赤、緑、青、暗めの白、各ゾーン、ブリージング、スペクトラム、消灯を再生し、各ステップを記録します。 |
自作のプロファイルは %APPDATA%\rgbtray\devices\ に置くと、アプリの再起動後に有効になります。key が同じものは組み込みプロファイルを置き換えます。各フィールドと各プロトコルのセクションは次を参照してください: docs/profiles.md.
デバイスが動いたら、プルリクエストでそのデバイスをすべての RGB Tray ユーザー向けの組み込みにできます。Claude が gh pr create で一通り代行できます:
profiles/<vendor>-<model>.toml に置き、src/devices/profile.rs の BUILT_IN に追加します。tested = true にするのは、実機で確認した場合のみです。cargo fmt --check、cargo clippy、cargo test。07
ファイルは 1 つだけ:インストーラーがアプリそのものです。ランタイムのインストールも管理者権限も不要です。
RGBTray-Setup-x.y.z.exe
RGBTray-Setup-<version>.exe をダウンロードします。%LOCALAPPDATA%\Programs\RGB Tray へ自身をインストールし、起動します。初回は SmartScreen が警告することがあります。 インストーラーにはまだコード署名がありません。詳細情報 → 実行 を選んでください。各リリースにはインストーラーの SHA-256 が記載されています。
メーカー製のライティングソフトウェアを終了してください。 2 つのプログラムが同じデバイスに書き込むと、互いに競合します。Windows 11 では「Logitech LampArray」サービス(ダイナミック ライティング)によって G915 がエフェクトを無視するようになります。RGB Tray はこれを警告し、無効化を提案します。
設定は安全です。 設定は %APPDATA%\rgbtray に保存され、アップデートや再インストール後も保持されます。直近 14 日間と各アップデート前のコピーは backups に保管され、設定ファイルが壊れた場合は正常に読める最新のコピーに置き換えられます。
Windows 10 または 11 と、stable 版の Rust(x86_64-pc-windows-gnu または -msvc ツールチェーン)が必要です。インストーラーは同じ実行ファイルです。RGBTray-Setup-*.exe という名前にすると、自身をインストールします。
git clone https://github.com/Gronck2/rgb-tray
cd rgb-tray
cargo build --release # target\release\rgbtray.exe
.\scripts\release.ps1 # dist\RGBTray-Setup-<version>.exe
RGB Tray は無料のオープンソースです。いちばん助かるのはコード不要の協力です:デバイスレポートの提供や、プロジェクトが持っていないハードウェアでのビルドのテスト。GitHub のスターも、他の人が見つける助けになります。
Issue やリクエストは GitHub に送ります。書き込むには無料の GitHub アカウントが必要です。