RGB Tray
Kostenlos Open Source Windows 10 / 11

RGB Tray

Die gesamte RGB-Beleuchtung aus einer winzigen Tray-App.

RGB Tray spricht direkt über HID mit Tastaturen, Mäusen und Lampen und über Ihr lokales Netzwerk mit Tuya-Lampen. Farbe, Effekt und Helligkeit für alles auf einmal oder pro Gerät, ohne dass Herstellersoftware im Hintergrund läuft.

Für Windows herunterladen Gerät hinzufügen

Statt G HUB Synapse Armoury Crate SignalRGB

Das Panel von RGB Tray: Farbe und Effekt für alle Geräte, globale Helligkeit und eine Karte für jedes Gerät

01

Warum eine kleine App

Jede Marke hat ihre eigene Beleuchtungs-App, und jede will im Hintergrund laufen. RGB Tray übernimmt die Beleuchtung für alle in einer einzigen.

  • Sonst nichts im Hintergrund

    Es spricht das Protokoll jedes Geräts selbst, daher müssen G HUB, Synapse, Armoury Crate oder SignalRGB nicht laufen. Die Installation braucht keine Administratorrechte.

  • Ein Panel für alles

    Ein Linksklick auf das Tray-Symbol öffnet das Panel: Farbe, Effekt und Helligkeit für alle Geräte auf einmal oder pro Gerät, dazu Voreinstellungen, die Sie auf globale Tastenkürzel legen können.

  • Es hält mit Ihrem PC Schritt

    Die Beleuchtung kommt nach dem Ruhezustand (auch Modern Standby) und beim Anstecken eines Geräts zurück, wird mit dem Bildschirm gedimmt und geht aus, solange der Bildschirm aus ist.

02

Unterstützte Geräte

Heute sechs Familien. Andere Modelle, die dieselben Protokolle sprechen, funktionieren möglicherweise auch, und ein neues lässt sich oft mit einer kleinen Textdatei hinzufügen.

Logitech

G915 TKL (LIGHTSPEED-Empfänger)

Statisch, Atmen, Spektrum und aus; Farben pro Taste mit einem Tasteneditor; die Wellen- und Ripple-Effekte der Firmware; Akku.

Razer

Naga V2 Pro, Mouse Dock Pro und rund 90 weitere

Basilisk, DeathAdder, Viper, Cobra, BlackWidow, Huntsman, Ornata, Firefly, Goliathus, Base Station und weitere aus den Daten von OpenRazer: Effekte, Zonen bei Mäusen, Akku. Die meisten sind ungetestet; ihre Karte weist darauf hin, und ein Bericht ist willkommen.

ASUS

Laptoptastaturen (Aura)

Statisch, Atmen, Spektrum und aus; die Tastaturzonen und die Gehäuseleuchten über LampArray. Die Tastatur setzt sich beim Aufwachen auf Weiß zurück, daher wird die Beleuchtung erneut angewendet.

QMK / VIA

Geekboard MacroPad v2, Keychron, Eigenbauten

Jede QMK-Tastatur mit VIA und RGB: statisch, Atmen, Spektrum, aus und Helligkeit. Farben werden nur im RAM gesetzt, die eigenen gespeicherten Einstellungen der Tastatur bleiben unberührt.

Windows Dynamische Beleuchtung

HID-LampArray-Geräte

Geräte mit dem LampArray-Standard: statisch, Atmen, Spektrum und aus, mit den Zonen, die das Gerät selbst beschreibt. Atmen und Spektrum werden von der App gezeichnet.

Tuya-Lampen

WLAN-Lampen in Smart Life, z. B. LINUS A60

Über das lokale Netzwerk: Farbe, Weiß mit seinem Farbton, Atmen, Spektrum und aus. Eine Lampe wird nicht mit dem Bildschirm dunkel. Sie braucht den lokalen Schlüssel der Lampe, der einmalig aus der Tuya-Cloud geholt wird.

Verbindungen, alle Razer-Modelle und wie man einen Tuya-Schlüssel bekommt stehen in der vollständigen Gerätetabelle auf GitHub.

03

Was sie kann

Klein, aber nicht spartanisch: das, wofür Sie sonst eine Hersteller-App öffnen würden.

  • Helligkeit und Geschwindigkeit

    Eine globale Helligkeit mit einer zusätzlichen pro Gerät; die Geschwindigkeit von Atmen und Spektrum, global und pro Gerät.

  • Tasteneditor

    Für die Logitech-Tastatur: Pinsel, Pipette, Regenbogen, Zweifarbverlauf, Voreinstellungen für WASD und nur Buchstaben, Hervorheben eines Wortes, gespeicherte Schemata, ANSI- und ISO-Layouts.

  • Voreinstellungen auf Tastenkürzeln

    Speichern Sie einen Look und schalten Sie mit einem globalen Tastenkürzel dorthin um, einschließlich F13–F24 mit Ctrl, Alt, Shift oder Win.

  • Ein Tastenkürzel pro Gerät

    Schaltet ein Gerät aus und wieder so ein, wie es war, zum Beispiel eine Zimmerlampe. Voreinstellungen bleiben unberührt.

  • Folgt dem Bildschirm

    Wird gedimmt, wenn Windows den Bildschirm dimmt, und geht aus, solange der Bildschirm aus ist: bei Inaktivität, gesperrt oder im Ruhezustand. Lässt sich abschalten.

  • Funk und Akku

    Akkustände, Warnungen bei 10 % und 5 % und der Status „No link“, solange ein Funkgerät schläft; seine Farben kommen beim Aufwachen zurück.

  • Viele Geräte, getrennt gehalten

    Identische Geräte haben eigene Einstellungen und werden an der Seriennummer unterschieden. Getrennte Geräte warten mit ihren Einstellungen in einem Archiv.

  • Setup teilen

    Alle Einstellungen exportieren und importieren oder eine Voreinstellung in eine Datei speichern: Sie wird auf die Geräte derselben Modelle des Empfängers angewendet.

  • Updates mit einem Klick

    Einmal am Tag fragt die App bei GitHub nach dem neuesten Release und zeigt eine Karte, die es installiert. Die Prüfung lässt sich abschalten.

  • Passt zu Windows

    Das Tray-Symbol zeigt die aktuelle Farbe, das Panel lässt sich im Vordergrund anheften, das Design folgt Windows, und die Oberfläche gibt es auf Englisch oder Russisch.

04

Ein Blick hinein

Das Panel im dunklen und im hellen Design und der Tasteneditor der Logitech G915 TKL. Zum Vergrößern anklicken.

Das Panel im dunklen Design mit Gerätekarten
Das Panel, dunkles Design
Das Panel im hellen Design mit Gerätekarten
Das Panel, helles Design
Der Tasteneditor mit Tastaturlayout, Pinselwerkzeugen und Voreinstellungen
Der Tasteneditor: Pinsel, Pipette, Verläufe, Voreinstellungen und Firmware-Effekte

05

Was sie nicht kann

Gut zu wissen, bevor Sie etwas deinstallieren.

  • Nur Windows. Es ist eine App für Windows 10 und 11; es gibt keine Version für macOS oder Linux.
  • Nur Beleuchtung. Keine Makros, Tastenbelegung, Maus-DPI oder Firmware-Updates.
  • Nicht neben Beleuchtungs-Apps der Hersteller. Zwei Programme, die auf dasselbe Gerät schreiben, kommen sich in die Quere: Schließen Sie zuerst die Beleuchtungssoftware von G HUB, Synapse, Armoury Crate, SignalRGB oder OpenRGB.
  • Kein Konto und keine Cloud. Sie geht nur für die tägliche Update-Prüfung ins Internet, die sich abschalten lässt, und zu Tuya-Lampen in Ihrem eigenen Netzwerk.
  • Nicht jedes Modell ist getestet. Die meisten Razer-Modelle stammen aus den Daten von OpenRazer und sind ungetestet; kabellose HyperSpeed-Tastaturen funktionieren vorerst nur per Kabel.
  • Noch nicht signiert. Windows SmartScreen warnt beim ersten Mal möglicherweise vor dem Installationsprogramm; siehe Download weiter unten.

06

Ihr Gerät fehlt in der Liste? Fügen Sie es selbst hinzu

Viele Geräte brauchen gar keinen Code, nur eine kleine Profildatei. Mit Claude Code müssen Sie nicht einmal Rust oder HID kennen: Claude übernimmt die Technik, Sie sehen sich die Lichter an.

Mit Claude Code: /add-device

Das Repository enthält einen /add-device-Skill für Claude Code. Er führt Claude vom Gerätebericht bis zu einem getesteten Profil oder Treiber und, wenn Sie möchten, bis zu einem Pull Request.

  1. Repository in Claude Code öffnen

    Klonen Sie auf dem Windows-PC, an dem das Gerät steckt, github.com/Gronck2/rgb-tray und starten Sie Claude Code in diesem Ordner. Für ein Profil genügen die Befehlszeilenwerkzeuge der installierten App; ein Treiber braucht Rust, und Claude hilft Ihnen bei der Installation.

  2. /add-device eingeben

    Sagen Sie, um welches Gerät es sich handelt und was daran leuchtet. Schließen Sie vorher die App des Herstellers, damit nicht zwei Programme um das Gerät kämpfen.

  3. Claude liest den Gerätebericht

    Es führt rgbtray --diagnose aus, findet Ihr Gerät an Hersteller- und Produkt-ID und sieht, welche seiner Schnittstellen ein Protokoll sprechen, das RGB Tray schon kennt.

  4. Es findet das Protokoll

    In OpenRGB oder OpenRazer, in einem USB-Mitschnitt der Hersteller-App, den Sie aufnehmen (so geht's), oder durch vorsichtiges Ausprobieren mit --hid-send, jeweils eines und nur mit Ihrem Ja.

  5. Sie sind seine Augen

    Es schreibt das Profil, prüft es mit --profile-check und spielt Farben, Zonen und Effekte mit --profile-test ab. Nach jedem Schritt fragt es, was das Gerät getan hat.

  6. Es funktioniert auf Ihrem PC

    Claude kopiert das Profil nach %APPDATA%\rgbtray\devices\; starten Sie RGB Tray neu, und das Gerät hat seine Karte im Panel. Dann fragt es, ob Sie es teilen möchten.

Claude kann die Lichter nicht sehen, also gilt nichts als funktionierend, bis Sie es sagen. Es sendet nie Firmware-Update-, Bootloader-, Werksreset- oder In-den-Flash-speichern-Befehle und fragt nach, bevor es einen selbst ausgedachten Report sendet. Reagiert ein Gerät nicht mehr, ziehen Sie es ab und stecken Sie es wieder an.

Vier Wege, der günstigste zuerst

Ob Sie mit Claude oder von Hand arbeiten: Das Gerät nimmt den ersten Weg, der passt.

  1. 1

    Es funktioniert schon

    HID-LampArray-Geräte und QMK-Tastaturen mit VIA werden von generischen Treibern gesteuert. Öffnen Sie das Panel und suchen Sie die Karte.

  2. 2

    Ein Profil für ein bekanntes Protokoll

    Ein neues Razer-Modell ist eine kleine TOML-Datei mit seinen Produkt-IDs, der Transaktions-ID und den LED-IDs aus OpenRazer. Ein QMK/VIA-Profil kann die Effekte der Firmware benennen.

  3. 3

    Ein [hid]-Profil

    Ein einfaches Protokoll, Reports mit der Farbe darin und ohne nötige Antworten, wird als Report-Vorlagen mit {r} {g} {b} geschrieben. Es beherrscht auch XOR- oder Summen-Prüfsummen, Reports zum „Übernehmen“ und „Zurückgeben“ der Kontrolle und Farben pro LED. Kein Kompilieren.

  4. 4

    Ein Rust-Treiber

    Ein Protokoll, das Antworten, einen Handshake oder Zustand braucht, ist ein Treiber: ein Modul, das den Device-Trait implementiert. CONTRIBUTING.md führt Schritt für Schritt durch.

Die Werkzeuge in der App

Profile werden mit der App selbst geschrieben und geprüft, ohne Build. Sie ist ein Windows-Programm ohne Konsole, daher schreibt jedes Werkzeug sein Ergebnis in die Datei, die Sie angeben.

BefehlWas er tut
rgbtray --diagnose report.txtJedes HID-Gerät und jede Schnittstelle, die von RGB Tray erkannten markiert, und die Profildateien mit Fehlern.
rgbtray --hid-send out.txt <vid:pid[:page[:usage]]> <feature|output|get> "<hex>"Sendet rohe Reports und hängt die Antworten an die Datei an, um ein Protokoll zu ermitteln.
rgbtray --profile-check out.txt my-device.tomlLiest ein Profil, ohne ein Gerät anzusprechen, und schreibt, was die App aus jedem Modell macht oder was daran falsch ist.
rgbtray --profile-test out.txt my-device.tomlSpielt Rot, Grün, Blau, gedimmtes Weiß, jede Zone, Atmen, Spektrum und aus auf dem Gerät eines [hid]-Profils ab und protokolliert jeden Schritt.

Ihre eigenen Profile kommen nach %APPDATA%\rgbtray\devices\ und gelten nach einem Neustart der App; eines mit demselben key ersetzt ein eingebautes Profil. Die Felder und alle Protokollabschnitte stehen in docs/profiles.md.

07

Herunterladen und installieren

Eine Datei: Das Installationsprogramm ist die App selbst. Keine Laufzeitumgebung zu installieren und keine Administratorrechte.

RGBTray-Setup-x.y.z.exe

  1. Laden Sie RGBTray-Setup-<version>.exe vom neuesten Release herunter.
  2. Führen Sie die Datei aus. Sie installiert sich für Ihren Windows-Benutzer nach %LOCALAPPDATA%\Programs\RGB Tray und startet.
  3. Klicken Sie auf das Tray-Symbol, um das Panel zu öffnen. RGB Tray entfernen Sie in den Windows-Einstellungen → Apps.
Für Windows herunterladen Alle Releases

SmartScreen warnt beim ersten Mal möglicherweise. Das Installationsprogramm ist noch nicht signiert: Wählen Sie Weitere Informationen → Trotzdem ausführen. Jedes Release nennt die SHA-256-Prüfsumme seines Installationsprogramms.

Beleuchtungssoftware der Hersteller schließen. Zwei Programme, die auf dasselbe Gerät schreiben, kommen sich in die Quere. Unter Windows 11 sorgt der Dienst „Logitech LampArray“ (Dynamische Beleuchtung) dafür, dass die G915 Effekte ignoriert; RGB Tray weist darauf hin und bietet an, ihn zu deaktivieren.

Ihre Einstellungen sind sicher. Sie liegen in %APPDATA%\rgbtray und bleiben bei Updates und Neuinstallationen erhalten. Kopien der letzten 14 Tage und von vor jedem Update liegen in backups, und eine beschädigte Einstellungsdatei wird durch die letzte funktionierende Kopie ersetzt.

Aus dem Quellcode bauen

Windows 10 oder 11 und stabiles Rust mit der Toolchain x86_64-pc-windows-gnu oder -msvc. Das Installationsprogramm ist dieselbe ausführbare Datei: Heißt sie RGBTray-Setup-*.exe, installiert sie sich selbst.

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

Helfen Sie mit, mehr Geräte zum Leuchten zu bringen

RGB Tray ist kostenlos und Open Source. Die nützlichste Hilfe braucht keinen Code: ein Gerätebericht oder der Test eines Builds auf Hardware, die das Projekt nicht hat. Und ein Stern auf GitHub hilft anderen, es zu finden.

Stern auf GitHub Problem melden Gerät anfragen

Issues und Anfragen gehen an GitHub; zum Schreiben dort braucht man ein kostenloses GitHub-Konto.