RGB Tray
無料 オープンソース Windows 10 / 11

RGB Tray

すべての RGB ライティングを、小さなトレイアプリ 1 つで。

RGB Tray は、キーボード、マウス、ライトを HID で直接、Tuya 電球をローカルネットワーク経由で制御します。色、エフェクト、明るさを全デバイス一括またはデバイスごとに設定でき、メーカー製ソフトウェアをバックグラウンドで動かす必要はありません。

代わりに G HUB Synapse Armoury Crate SignalRGB

01

小さなアプリ 1 つで済む理由

ブランドごとに専用のライティングアプリがあり、どれもバックグラウンドで動こうとします。RGB Tray は、そのライティング部分をまとめて 1 つで担います。

  • バックグラウンドに他は不要

    各デバイスのプロトコルを自分で話すため、G HUB、Synapse、Armoury Crate、SignalRGB を動かしておく必要はありません。インストールに管理者権限は不要です。

  • すべてを 1 つのパネルで

    トレイアイコンを左クリックするとパネルが開きます。色、エフェクト、明るさを全デバイス一括またはデバイスごとに設定でき、グローバルホットキーに割り当てられるプリセットもあります。

  • PC の状態に追従

    スリープ(モダン スタンバイを含む)からの復帰時やデバイスの接続時にライティングが戻り、画面に合わせて暗くなり、画面がオフの間は消灯します。

02

対応デバイス

現在は 6 つのファミリーに対応しています。同じプロトコルを使う他のモデルも動作する可能性があり、新しいモデルは小さなテキストファイルで追加できることがよくあります。

Logitech

G915 TKL(LIGHTSPEED レシーバー)

固定色、ブリージング、スペクトラム、消灯。キーエディターによるキーごとの色。ファームウェアのウェーブとリップルのエフェクト。バッテリー。

Razer

Naga V2 Pro、Mouse Dock Pro ほか約 90 種

Basilisk、DeathAdder、Viper、Cobra、BlackWidow、Huntsman、Ornata、Firefly、Goliathus、Base Station など、OpenRazer のデータに基づく機種:エフェクト、マウスのゾーン、バッテリー。大半は未検証で、その旨がカードに表示されます。動作報告を歓迎します。

ASUS

ノート PC のキーボード(Aura)

固定色、ブリージング、スペクトラム、消灯。LampArray によるキーボードのゾーンと本体のランプ。キーボードは復帰時に白へリセットされるため、ライティングを再適用します。

QMK / VIA

Geekboard MacroPad v2、Keychron、自作キーボード

VIA と RGB に対応した任意の QMK キーボード:固定色、ブリージング、スペクトラム、消灯、明るさ。色は RAM にのみ設定されるため、キーボード自身の保存済み設定には手を加えません。

Windows のダイナミック ライティング

HID LampArray デバイス

LampArray 規格に対応したデバイス:固定色、ブリージング、スペクトラム、消灯、およびデバイス自身が示すゾーン。ブリージングとスペクトラムはアプリ側で描画します。

Tuya 電球

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 になじむ

    トレイアイコンが現在の色を表示し、パネルは最前面にピン留めでき、テーマは Windows に追従し、インターフェースは英語とロシア語です。

04

中を見てみる

ダークテーマとライトテーマのパネル、そして Logitech G915 TKL のキーごとのエディター。クリックで拡大します。

05

できないこと

何かをアンインストールする前に知っておきたい点です。

  • Windows 専用。 Windows 10 と 11 用のアプリで、macOS や Linux 版はありません。
  • ライティングのみ。 マクロ、キーの割り当て変更、マウスの DPI、ファームウェア更新には対応しません。
  • メーカー製ライティングアプリとは併用不可。 2 つのプログラムが同じデバイスに書き込むと互いに競合します。先に G HUB、Synapse、Armoury Crate、SignalRGB、OpenRGB のライティングソフトウェアを終了してください。
  • アカウントもクラウドも不要。 インターネットに接続するのは、毎日のアップデート確認(オフにできます)と、同じネットワーク内の Tuya 電球への通信だけです。
  • すべてのモデルを検証しているわけではありません。 Razer のモデルの大半は OpenRazer のデータに基づく未検証のもので、ワイヤレスの HyperSpeed キーボードは現在のところ有線接続時のみ動作します。
  • まだコード署名がありません。 Windows SmartScreen が初回にインストーラーを警告することがあります。下のダウンロードを参照してください。

06

デバイスが一覧にない?自分で追加できます

多くのデバイスはコード不要で、小さなプロファイルファイルだけで動きます。Claude Code を使えば、Rust や HID の知識も不要です。技術的な作業は Claude が行い、あなたはライトを見るだけです。

Claude Code で:/add-device

このリポジトリには Claude Code 用の /add-device スキルが付属しています。Claude はデバイスレポートから、テスト済みのプロファイルまたはドライバーまで、ご希望ならプルリクエストまで進めます。

  1. Claude Code でリポジトリを開く

    デバイスをつないだ Windows PC で github.com/Gronck2/rgb-tray をクローンし、そのフォルダーで Claude Code を起動します。プロファイルならインストール済みアプリのコマンドラインツールで足ります。ドライバーには Rust が必要で、Claude がインストールを手伝います。

  2. /add-device と入力

    どのデバイスか、どこが光るのかを伝えます。2 つのプログラムがデバイスを奪い合わないよう、先にメーカー製アプリを終了してください。

  3. Claude がデバイスレポートを読む

    rgbtray --diagnose を実行し、ベンダー ID とプロダクト ID からデバイスを見つけ、RGB Tray がすでに知っているプロトコルを話すインターフェースがどれかを調べます。

  4. プロトコルを探す

    OpenRGB や OpenRazer の中、あなたが記録したメーカー製アプリの USB キャプチャ(手順)、または --hid-send による慎重な試行で探します。試行は 1 回ずつ、あなたの了承を得てからのみです。

  5. あなたが Claude の目になる

    プロファイルを書き、--profile-check で確認し、--profile-test で色、ゾーン、エフェクトを再生します。各ステップのあとで、デバイスがどう反応したかを尋ねます。

  6. あなたの PC で動く

    Claude がプロファイルを %APPDATA%\rgbtray\devices\ にコピーします。RGB Tray を再起動すると、デバイスのカードがパネルに表示されます。そのあと、共有したいかどうかを尋ねます。

Claude にはライトが見えないため、あなたが確認するまで動作したことにはなりません。ファームウェア更新、ブートローダー、工場出荷状態へのリセット、フラッシュへの保存のコマンドは決して送らず、自分で考えたレポートを送る前には必ず確認します。デバイスが応答しなくなったら、いったん抜いて挿し直してください。

4 つの方法、手軽なものから順に

Claude と進める場合も手作業の場合も、デバイスには最初に当てはまる方法が使われます。

  1. 1

    すでに動く

    HID LampArray デバイスと、VIA 対応の QMK キーボードは、汎用ドライバーで制御されます。パネルを開いてカードを探してください。

  2. 2

    既知のプロトコル用のプロファイル

    新しい Razer モデルは、プロダクト ID、トランザクション ID、LED ID を記した小さな TOML ファイルです。値は OpenRazer から取ります。QMK/VIA のプロファイルではファームウェアのエフェクトを指定できます。

  3. 3

    [hid] プロファイル

    単純なプロトコル(色を含むレポートで、応答が不要なもの)は、{r} {g} {b} を使ったレポートテンプレートとして記述します。XOR や合計のチェックサム、「制御を取得」「制御を返す」レポート、LED ごとの色にも対応します。コンパイル不要です。

  4. 4

    Rust ドライバー

    応答、ハンドシェイク、状態が必要なプロトコルにはドライバーを使います。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.

07

ダウンロードとインストール

ファイルは 1 つだけ:インストーラーがアプリそのものです。ランタイムのインストールも管理者権限も不要です。

RGBTray-Setup-x.y.z.exe

  1. 最新リリースから RGBTray-Setup-<version>.exe をダウンロードします。
  2. 実行します。現在の Windows ユーザー向けに %LOCALAPPDATA%\Programs\RGB Tray へ自身をインストールし、起動します。
  3. トレイアイコンをクリックするとパネルが開きます。RGB Tray は Windows の設定 → アプリから削除できます。

初回は 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 アカウントが必要です。