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.
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
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.
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 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.
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
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.
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.
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.
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é.
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.
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 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
Petite, mais pas dépouillée : ce pour quoi vous ouvririez autrement une application constructeur.
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.
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.
Enregistrez un rendu et passez-y avec un raccourci clavier global, y compris F13–F24 avec Ctrl, Alt, Shift ou Win.
É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.
Baisse quand Windows assombrit l'écran et s'éteint tant que l'écran est éteint : inactivité, verrouillage ou veille. Désactivable.
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.
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.
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.
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.
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.
05
Bon à savoir avant de désinstaller quoi que ce soit.
06
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.
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.
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.
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.
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à.
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.
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.
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.
Que vous travailliez avec Claude ou à la main, le périphérique emprunte la première voie qui convient.
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.
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.
[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.
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 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.
| Commande | Rôle |
|---|---|
rgbtray --diagnose report.txt | Chaque 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.toml | Lit 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.toml | Joue 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.
Quand votre périphérique fonctionne, une pull request l'intègre pour tous les utilisateurs de RGB Tray. Claude peut tout faire pour vous avec gh pr create :
profiles/<vendor>-<model>.toml et dans BUILT_IN de src/devices/profile.rs, avec tested = true seulement s'il a été vérifié sur le périphérique.cargo fmt --check, cargo clippy et cargo test.07
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
RGBTray-Setup-<version>.exe depuis la dernière version.%LOCALAPPDATA%\Programs\RGB Tray et démarre.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.
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
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.