RGB Tray
Gratuit Open source Windows 10 / 11

RGB Tray

Tout votre éclairage RGB depuis une minuscule application de la zone de notification.

RGB Tray parle directement en HID aux claviers, souris et lampes, et aux ampoules Tuya via votre réseau local. Couleur, effet et luminosité pour tout à la fois ou périphérique par périphérique, sans logiciel constructeur tournant en arrière-plan.

À la place de G HUB Synapse Armoury Crate SignalRGB

01

Pourquoi une seule petite application

Chaque marque a sa propre application d'éclairage, et chacune veut tourner en arrière-plan. RGB Tray s'occupe de l'éclairage de toutes en une seule.

  • Rien d'autre en arrière-plan

    Elle parle elle-même le protocole de chaque périphérique, donc G HUB, Synapse, Armoury Crate ou SignalRGB n'ont pas besoin de tourner. L'installation ne demande aucun droit d'administrateur.

  • Un seul panneau pour tout

    Un clic gauche sur l'icône de la zone de notification ouvre le panneau : couleur, effet et luminosité pour tous les périphériques à la fois ou un par un, et des préréglages que vous pouvez placer sur des raccourcis clavier globaux.

  • Elle suit votre PC

    L'éclairage revient après la mise en veille (y compris Modern Standby) et lorsqu'un périphérique est branché, baisse avec l'écran et s'éteint tant que l'écran est éteint.

02

Périphériques pris en charge

Six familles aujourd'hui. D'autres modèles utilisant les mêmes protocoles peuvent fonctionner aussi, et on peut souvent en ajouter un nouveau avec un petit fichier texte.

Logitech

G915 TKL (récepteur LIGHTSPEED)

Statique, respiration, spectre et éteint ; couleurs touche par touche avec un éditeur de touches ; les effets de vague et d'ondulation du firmware ; batterie.

Razer

Naga V2 Pro, Mouse Dock Pro et environ 90 autres

Basilisk, DeathAdder, Viper, Cobra, BlackWidow, Huntsman, Ornata, Firefly, Goliathus, Base Station et d'autres, d'après les données d'OpenRazer : effets, zones des souris, batterie. La plupart n'ont pas été testés ; leur carte l'indique, et tout retour est le bienvenu.

ASUS

Claviers de portables (Aura)

Statique, respiration, spectre et éteint ; les zones du clavier et les lampes du châssis via LampArray. Le clavier repasse au blanc au réveil, l'éclairage est donc réappliqué.

QMK / VIA

Geekboard MacroPad v2, Keychron, claviers personnalisés

Tout clavier QMK avec VIA et RGB : statique, respiration, spectre, éteint et luminosité. Les couleurs ne sont écrites qu'en RAM, les réglages enregistrés du clavier restent donc intacts.

Éclairage dynamique de Windows

Périphériques HID LampArray

Périphériques conformes au standard LampArray : statique, respiration, spectre et éteint, avec les zones que le périphérique décrit lui-même. La respiration et le spectre sont dessinés par l'application.

Ampoules Tuya

Ampoules Wi-Fi dans Smart Life, par ex. LINUS A60

Via le réseau local : couleur, blanc avec sa teinte, respiration, spectre et éteint. Une ampoule ne s'éteint pas avec l'écran. Elle nécessite la clé locale de l'ampoule, récupérée une fois pour toutes dans le cloud Tuya.

Les connexions, tous les modèles Razer et la façon d'obtenir une clé Tuya se trouvent dans le tableau complet des périphériques sur GitHub.

03

Ce qu'elle fait

Petite, mais pas dépouillée : ce pour quoi vous ouvririez autrement une application constructeur.

  • Luminosité et vitesse

    Une luminosité globale à laquelle s'ajoute une luminosité par périphérique ; la vitesse de la respiration et du spectre, globale et par périphérique.

  • Éditeur touche par touche

    Pour le clavier Logitech : pinceau, pipette, arc-en-ciel, dégradé bicolore, préréglages WASD et lettres seules, mise en surbrillance d'un mot, schémas enregistrés, dispositions ANSI et ISO.

  • Préréglages sur raccourcis clavier

    Enregistrez un rendu et passez-y avec un raccourci clavier global, y compris F13–F24 avec Ctrl, Alt, Shift ou Win.

  • Un raccourci par périphérique

    Éteint un périphérique puis le rallume dans son état précédent, par exemple une lampe de pièce. Les préréglages ne sont pas affectés.

  • Suit l'écran

    Baisse quand Windows assombrit l'écran et s'éteint tant que l'écran est éteint : inactivité, verrouillage ou veille. Désactivable.

  • Sans fil et batterie

    Niveaux de batterie, alertes à 10 % et 5 %, et statut « No link » pendant qu'un périphérique sans fil est en veille ; ses couleurs reviennent à son réveil.

  • Plusieurs périphériques, bien distincts

    Les périphériques identiques ont leurs propres réglages, distingués par leur numéro de série. Les périphériques déconnectés attendent dans une archive avec leurs réglages.

  • Partagez votre configuration

    Exportez et importez tous les réglages, ou enregistrez un préréglage dans un fichier : il s'applique aux périphériques des mêmes modèles du destinataire.

  • Mises à jour en un clic

    Une fois par jour, l'application interroge GitHub sur la dernière version et affiche une carte qui l'installe. La vérification peut être désactivée.

  • S'intègre à Windows

    L'icône de la zone de notification affiche la couleur actuelle, le panneau peut être épinglé au premier plan, le thème suit celui de Windows, et l'interface est en anglais ou en russe.

04

Un coup d'œil à l'intérieur

Le panneau en thème sombre et en thème clair, et l'éditeur touche par touche du Logitech G915 TKL. Cliquez pour agrandir.

05

Ce qu'elle ne fait pas

Bon à savoir avant de désinstaller quoi que ce soit.

  • Windows uniquement. C'est une application pour Windows 10 et 11 ; il n'existe pas de version macOS ni Linux.
  • Éclairage uniquement. Pas de macros, de réaffectation des touches, de DPI de souris ni de mises à jour du firmware.
  • Pas à côté des applications d'éclairage des constructeurs. Deux programmes qui écrivent sur le même périphérique se contrarient : fermez d'abord le logiciel d'éclairage de G HUB, Synapse, Armoury Crate, SignalRGB ou OpenRGB.
  • Ni compte ni cloud. Elle ne se connecte à Internet que pour la vérification quotidienne des mises à jour, qui peut être désactivée, et aux ampoules Tuya de votre propre réseau.
  • Tous les modèles ne sont pas testés. La plupart des modèles Razer viennent des données d'OpenRazer et n'ont pas été testés ; les claviers sans fil HyperSpeed ne fonctionnent pour l'instant qu'en filaire.
  • Pas encore signée. Windows SmartScreen peut afficher un avertissement à propos du programme d'installation la première fois ; voir Télécharger plus bas.

06

Votre périphérique n'est pas dans la liste ? Ajoutez-le vous-même

Beaucoup de périphériques n'ont besoin d'aucun code, seulement d'un petit fichier de profil. Avec Claude Code, vous n'avez même pas besoin de connaître Rust ni HID : Claude fait le travail technique, vous regardez les lumières.

Avec Claude Code : /add-device

Le dépôt contient un skill /add-device pour Claude Code. Il mène Claude du rapport du périphérique à un profil ou un pilote testé, et à une pull request si vous le souhaitez.

  1. Ouvrez le dépôt dans Claude Code

    Sur le PC Windows où le périphérique est branché, clonez github.com/Gronck2/rgb-tray et lancez Claude Code dans ce dossier. Pour un profil, les outils en ligne de commande de l'application installée suffisent ; un pilote nécessite Rust, et Claude vous aide à l'installer.

  2. Tapez /add-device

    Dites de quel périphérique il s'agit et ce qui s'y allume. Quittez d'abord l'application du constructeur, pour que deux programmes ne se disputent pas le périphérique.

  3. Claude lit le rapport du périphérique

    Il exécute rgbtray --diagnose, trouve votre périphérique grâce à ses identifiants de constructeur et de produit, et repère lesquelles de ses interfaces parlent un protocole que RGB Tray connaît déjà.

  4. Il trouve le protocole

    Dans OpenRGB ou OpenRazer, dans une capture USB du logiciel constructeur que vous enregistrez (comment faire), ou par des essais prudents avec --hid-send, un à la fois et seulement avec votre accord.

  5. Vous êtes ses yeux

    Il écrit le profil, le vérifie avec --profile-check et joue les couleurs, les zones et les effets avec --profile-test. Après chaque étape, il demande ce qu'a fait le périphérique.

  6. Ça fonctionne sur votre PC

    Claude copie le profil dans %APPDATA%\rgbtray\devices\ ; redémarrez RGB Tray et le périphérique a sa carte sur le panneau. Il demande ensuite si vous voulez le partager.

Claude ne voit pas les lumières : rien n'est considéré comme fonctionnel tant que vous ne le dites pas. Il n'envoie jamais de commandes de mise à jour du firmware, de bootloader, de réinitialisation d'usine ni d'écriture en mémoire flash, et il demande avant d'envoyer un rapport qu'il a imaginé. Si un périphérique ne répond plus, débranchez-le puis rebranchez-le.

Quatre voies, la moins coûteuse d'abord

Que vous travailliez avec Claude ou à la main, le périphérique emprunte la première voie qui convient.

  1. 1

    Ça fonctionne déjà

    Les périphériques HID LampArray et les claviers QMK avec VIA sont pilotés par des pilotes génériques. Ouvrez le panneau et cherchez la carte.

  2. 2

    Un profil pour un protocole connu

    Un nouveau modèle Razer est un petit fichier TOML avec ses identifiants de produit, l'identifiant de transaction et les identifiants de LED, tirés d'OpenRazer. Un profil QMK/VIA peut nommer les effets du firmware.

  3. 3

    Un profil [hid]

    Un protocole simple, des rapports contenant la couleur et sans réponse nécessaire, s'écrit sous forme de modèles de rapports avec {r} {g} {b}. Il gère aussi les sommes de contrôle XOR ou par somme, les rapports de « prise de contrôle » et de « restitution », et les couleurs par LED. Sans compilation.

  4. 4

    Un pilote Rust

    Un protocole qui nécessite des réponses, une poignée de main ou un état est un pilote : un module qui implémente le trait Device. CONTRIBUTING.md en détaille les étapes.

Les outils de l'application

Les profils s'écrivent et se vérifient avec l'application elle-même, sans compilation. C'est un programme Windows sans console : chaque outil écrit donc son résultat dans le fichier que vous indiquez.

CommandeRôle
rgbtray --diagnose report.txtChaque périphérique et interface HID, ceux que RGB Tray connaît étant signalés, et les fichiers de profil contenant des erreurs.
rgbtray --hid-send out.txt <vid:pid[:page[:usage]]> <feature|output|get> "<hex>"Envoie des rapports bruts et ajoute les réponses au fichier, pour décortiquer un protocole.
rgbtray --profile-check out.txt my-device.tomlLit un profil sans toucher à aucun périphérique et écrit ce que l'application comprend de chaque modèle, ou ce qui ne va pas.
rgbtray --profile-test out.txt my-device.tomlJoue rouge, vert, bleu, blanc atténué, chaque zone, respiration, spectre et éteint sur le périphérique d'un profil [hid], en consignant chaque étape.

Vos propres profils vont dans %APPDATA%\rgbtray\devices\ et sont pris en compte après un redémarrage de l'application ; un profil avec le même key remplace un profil intégré. Les champs et chaque section de protocole sont décrits dans docs/profiles.md.

07

Télécharger et installer

Un seul fichier : le programme d'installation est l'application elle-même. Aucun environnement d'exécution à installer et aucun droit d'administrateur.

RGBTray-Setup-x.y.z.exe

  1. Téléchargez RGBTray-Setup-<version>.exe depuis la dernière version.
  2. Lancez-le. Il s'installe pour votre utilisateur Windows dans %LOCALAPPDATA%\Programs\RGB Tray et démarre.
  3. Cliquez sur l'icône de la zone de notification pour ouvrir le panneau. RGB Tray se désinstalle depuis Paramètres Windows → Applications.

SmartScreen peut afficher un avertissement la première fois. Le programme d'installation n'est pas encore signé : choisissez Informations complémentaires → Exécuter quand même. Chaque version indique le SHA-256 de son programme d'installation.

Fermez les logiciels d'éclairage des constructeurs. Deux programmes qui écrivent sur le même périphérique se contrarient. Sous Windows 11, le service « Logitech LampArray » (Éclairage dynamique) fait ignorer les effets au G915 ; RGB Tray vous en avertit et propose de le désactiver.

Vos réglages sont en sécurité. Ils sont stockés dans %APPDATA%\rgbtray et sont conservés lors des mises à jour et réinstallations. Des copies des 14 derniers jours et d'avant chaque mise à jour sont gardées dans backups, et un fichier de réglages endommagé est remplacé par la dernière copie valide.

Compiler depuis les sources

Windows 10 ou 11 et Rust stable avec la chaîne d'outils x86_64-pc-windows-gnu ou -msvc. Le programme d'installation est le même exécutable : nommé RGBTray-Setup-*.exe, il s'installe lui-même.

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

Aidez-la à éclairer plus de périphériques

RGB Tray est gratuit et open source. L'aide la plus utile ne demande aucun code : un rapport de périphérique, ou le test d'une version sur du matériel que le projet n'a pas. Et une étoile sur GitHub aide d'autres personnes à le trouver.

Les tickets et demandes vont sur GitHub ; pour y écrire, il faut un compte GitHub gratuit.