RGB Tray
Gratuita Código abierto Windows 10 / 11

RGB Tray

Toda tu iluminación RGB desde una diminuta aplicación de bandeja.

RGB Tray controla teclados, ratones y luces directamente por HID, y las bombillas Tuya por tu red local. Color, efecto y brillo para todo a la vez o para cada dispositivo por separado, sin software del fabricante ejecutándose en segundo plano.

Descargar para Windows Añade tu dispositivo

En lugar de G HUB Synapse Armoury Crate SignalRGB

El panel de RGB Tray: un color y un efecto para todos los dispositivos, el brillo global y una tarjeta para cada dispositivo

01

Por qué una sola aplicación pequeña

Cada marca tiene su propia aplicación de iluminación, y todas quieren ejecutarse en segundo plano. RGB Tray se encarga de la iluminación de todas ellas en una sola.

  • Nada más en segundo plano

    Ella misma habla el protocolo de cada dispositivo, así que G HUB, Synapse, Armoury Crate o SignalRGB no tienen que estar ejecutándose. La instalación no requiere derechos de administrador.

  • Un único panel para todo

    Un clic izquierdo en el icono de la bandeja abre el panel: color, efecto y brillo para todos los dispositivos a la vez o por dispositivo, y preajustes que puedes asignar a atajos de teclado globales.

  • Sigue el ritmo de tu PC

    La iluminación vuelve tras la suspensión (incluido Modern Standby) y al conectar un dispositivo, se atenúa con la pantalla y se apaga mientras la pantalla está apagada.

02

Dispositivos compatibles

Seis familias por ahora. Otros modelos que usen los mismos protocolos pueden funcionar también, y a menudo se puede añadir uno nuevo con un pequeño archivo de texto.

Logitech

G915 TKL (receptor LIGHTSPEED)

Estático, respiración, espectro y apagado; colores por tecla con un editor de teclas; los efectos de onda y ondulación del firmware; batería.

Razer

Naga V2 Pro, Mouse Dock Pro y unos 90 más

Basilisk, DeathAdder, Viper, Cobra, BlackWidow, Huntsman, Ornata, Firefly, Goliathus, Base Station y otros, a partir de los datos de OpenRazer: efectos, zonas de los ratones, batería. La mayoría están sin probar; su tarjeta lo indica, y cualquier informe es bienvenido.

ASUS

Teclados de portátil (Aura)

Estático, respiración, espectro y apagado; las zonas del teclado y las luces del chasis mediante LampArray. El teclado se restablece a blanco al despertar, así que la iluminación se vuelve a aplicar.

QMK / VIA

Geekboard MacroPad v2, Keychron, teclados personalizados

Cualquier teclado QMK con VIA y RGB: estático, respiración, espectro, apagado y brillo. Los colores se fijan solo en la RAM, así que los ajustes guardados del propio teclado no se tocan.

Iluminación dinámica de Windows

Dispositivos HID LampArray

Dispositivos con el estándar LampArray: estático, respiración, espectro y apagado, con las zonas que el propio dispositivo describe. La respiración y el espectro los dibuja la aplicación.

Bombillas Tuya

Bombillas Wi-Fi en Smart Life, p. ej. LINUS A60

Por la red local: color, blanco con su tono, respiración, espectro y apagado. Una bombilla no se apaga junto con la pantalla. Requiere la clave local de la bombilla, que se obtiene una vez de la nube de Tuya.

Las conexiones, todos los modelos Razer y cómo obtener una clave Tuya están en la tabla completa de dispositivos en GitHub.

03

Qué hace

Pequeña, pero no básica: lo que de otro modo tendrías que abrir una aplicación del fabricante para hacer.

  • Brillo y velocidad

    Un brillo global y, encima, uno por dispositivo; la velocidad de la respiración y del espectro, global y por dispositivo.

  • Editor por tecla

    Para el teclado Logitech: pincel, cuentagotas, arcoíris, degradado de dos colores, preajustes WASD y de solo letras, resaltado de una palabra, esquemas guardados, distribuciones ANSI e ISO.

  • Preajustes con atajos de teclado

    Guarda un aspecto y cámbiate a él con un atajo de teclado global, incluidas F13–F24 con Ctrl, Alt, Shift o Win.

  • Un atajo por dispositivo

    Apaga un dispositivo y lo vuelve a encender tal como estaba, por ejemplo una lámpara de la habitación. Los preajustes no se ven afectados.

  • Sigue a la pantalla

    Se atenúa cuando Windows atenúa la pantalla y se apaga mientras la pantalla está apagada: inactividad, bloqueo o suspensión. Se puede desactivar.

  • Inalámbricos y batería

    Niveles de batería, avisos al 10 % y al 5 %, y un estado “No link” mientras un dispositivo inalámbrico está en reposo; sus colores vuelven cuando despierta.

  • Muchos dispositivos, cada uno aparte

    Los dispositivos idénticos tienen sus propios ajustes, distinguidos por el número de serie. Los desconectados esperan en un archivo con sus ajustes.

  • Comparte tu configuración

    Exporta e importa todos los ajustes, o guarda un preajuste en un archivo: se aplica a los dispositivos de los mismos modelos de quien lo recibe.

  • Actualizaciones con un clic

    Una vez al día la aplicación consulta en GitHub la última versión y muestra una tarjeta que la instala. La comprobación se puede desactivar.

  • Integrada en Windows

    El icono de la bandeja muestra el color actual, el panel se puede fijar por encima de las demás ventanas, el tema sigue a Windows y la interfaz está en inglés o ruso.

04

Un vistazo por dentro

El panel en el tema oscuro y en el claro, y el editor por tecla del Logitech G915 TKL. Haz clic para ampliar.

El panel en el tema oscuro con las tarjetas de los dispositivos
El panel, tema oscuro
El panel en el tema claro con las tarjetas de los dispositivos
El panel, tema claro
El editor por tecla con una distribución de teclado, herramientas de pincel y preajustes
El editor por tecla: pincel, cuentagotas, degradados, preajustes y efectos de firmware

05

Qué no hace

Conviene saberlo antes de desinstalar nada.

  • Solo Windows. Es una aplicación para Windows 10 y 11; no hay versión para macOS ni Linux.
  • Solo iluminación. Sin macros, reasignación de teclas, DPI del ratón ni actualizaciones de firmware.
  • No junto a las aplicaciones de iluminación del fabricante. Dos programas que escriben en el mismo dispositivo se estorban entre sí: cierra primero el software de iluminación de G HUB, Synapse, Armoury Crate, SignalRGB u OpenRGB.
  • Sin cuenta y sin nube. Solo se conecta a internet para la comprobación diaria de actualizaciones, que se puede desactivar, y a las bombillas Tuya de tu propia red.
  • No todos los modelos están probados. La mayoría de los modelos Razer salen de los datos de OpenRazer y están sin probar; los teclados inalámbricos HyperSpeed, por ahora, solo funcionan por cable.
  • Aún sin firma digital. Windows SmartScreen puede mostrar una advertencia sobre el instalador la primera vez; consulta Descarga e instalación más abajo.

06

¿Tu dispositivo no está en la lista? Añádelo tú mismo

Muchos dispositivos no necesitan nada de código, solo un pequeño archivo de perfil. Con Claude Code ni siquiera necesitas saber Rust ni HID: Claude hace el trabajo técnico y tú miras las luces.

Con Claude Code: /add-device

El repositorio incluye una skill /add-device para Claude Code. Lleva a Claude desde el informe del dispositivo hasta un perfil o un controlador probado, y hasta un pull request si quieres uno.

  1. Abre el repositorio en Claude Code

    En el PC con Windows al que está conectado el dispositivo, clona github.com/Gronck2/rgb-tray e inicia Claude Code en esa carpeta. Para un perfil bastan las herramientas de línea de comandos de la aplicación instalada; un controlador necesita Rust, y Claude te ayuda a instalarlo.

  2. Escribe /add-device

    Di de qué dispositivo se trata y qué se ilumina en él. Cierra antes la aplicación del fabricante, para que dos programas no se disputen el dispositivo.

  3. Claude lee el informe del dispositivo

    Ejecuta rgbtray --diagnose, encuentra tu dispositivo por sus ids de fabricante y de producto y ve cuáles de sus interfaces hablan un protocolo que RGB Tray ya conoce.

  4. Encuentra el protocolo

    En OpenRGB u OpenRazer, en una captura USB de la aplicación del fabricante que tú grabas (cómo), o con pruebas cuidadosas con --hid-send, de una en una y solo con tu visto bueno.

  5. Tú eres sus ojos

    Escribe el perfil, lo comprueba con --profile-check y reproduce colores, zonas y efectos con --profile-test. Después de cada paso te pregunta qué hizo el dispositivo.

  6. Funciona en tu PC

    Claude copia el perfil en %APPDATA%\rgbtray\devices\; reinicia RGB Tray y el dispositivo tiene su tarjeta en el panel. Después te pregunta si quieres compartirlo.

Claude no puede ver las luces, así que nada cuenta como funcionando hasta que tú lo digas. Nunca envía comandos de actualización de firmware, de bootloader, de restablecimiento de fábrica ni de guardado en la memoria flash, y pregunta antes de enviar cualquier informe que se haya inventado. Si un dispositivo deja de responder, desconéctalo y vuelve a conectarlo.

Cuatro rutas, la más sencilla primero

Tanto si trabajas con Claude como a mano, el dispositivo toma la primera ruta que le sirva.

  1. 1

    Ya funciona

    Los dispositivos HID LampArray y los teclados QMK con VIA los controlan controladores genéricos. Abre el panel y busca la tarjeta.

  2. 2

    Un perfil para un protocolo conocido

    Un modelo Razer nuevo es un pequeño archivo TOML con sus ids de producto, id de transacción e ids de LED, tomados de OpenRazer. Un perfil QMK/VIA puede nombrar los efectos del firmware.

  3. 3

    Un perfil [hid]

    Un protocolo sencillo, con informes que llevan el color dentro y sin necesidad de respuestas, se escribe como plantillas de informe con {r} {g} {b}. También admite sumas de verificación XOR o de suma, informes de «tomar el control» y «devolverlo», y colores por LED. Sin compilar.

  4. 4

    Un controlador en Rust

    Un protocolo que necesita respuestas, un handshake o estado es un controlador: un módulo que implementa el trait Device. CONTRIBUTING.md lo explica paso a paso.

Las herramientas de la aplicación

Los perfiles se escriben y se comprueban con la propia aplicación, sin compilar nada. Es un programa de Windows sin consola, así que cada herramienta escribe su resultado en el archivo que indiques.

ComandoQué hace
rgbtray --diagnose report.txtTodos los dispositivos e interfaces HID, con los que RGB Tray conoce marcados, y los archivos de perfil con errores.
rgbtray --hid-send out.txt <vid:pid[:page[:usage]]> <feature|output|get> "<hex>"Envía informes sin procesar y añade las respuestas al archivo, para descifrar un protocolo.
rgbtray --profile-check out.txt my-device.tomlLee un perfil sin tocar ningún dispositivo y escribe qué entiende la aplicación de cada modelo, o qué tiene de incorrecto.
rgbtray --profile-test out.txt my-device.tomlReproduce rojo, verde, azul, blanco tenue, cada zona, respiración, espectro y apagado en el dispositivo de un perfil [hid], registrando cada paso.

Tus propios perfiles van en %APPDATA%\rgbtray\devices\ y funcionan tras reiniciar la aplicación; uno con la misma key sustituye a un perfil integrado. Los campos y todas las secciones de protocolo están en docs/profiles.md.

07

Descarga e instalación

Un solo archivo: el instalador es la propia aplicación. Sin instalar ningún runtime y sin derechos de administrador.

RGBTray-Setup-x.y.z.exe

  1. Descarga RGBTray-Setup-<version>.exe de la última versión.
  2. Ejecútalo. Se instala solo para tu usuario de Windows en %LOCALAPPDATA%\Programs\RGB Tray y se inicia.
  3. Haz clic en el icono de la bandeja para abrir el panel. RGB Tray se desinstala desde Configuración de Windows → Aplicaciones.
Descargar para Windows Todas las versiones

SmartScreen puede mostrar una advertencia la primera vez. El instalador aún no está firmado digitalmente: elige Más información → Ejecutar de todas formas. Cada versión indica el SHA-256 de su instalador.

Cierra el software de iluminación del fabricante. Dos programas que escriben en el mismo dispositivo se estorban entre sí. En Windows 11, el servicio “Logitech LampArray” (Iluminación dinámica) hace que el G915 ignore los efectos; RGB Tray avisa de ello y ofrece desactivarlo.

Tus ajustes están a salvo. Se guardan en %APPDATA%\rgbtray y se conservan tras actualizaciones y reinstalaciones. Las copias de los últimos 14 días y de antes de cada actualización se guardan en backups, y un archivo de ajustes dañado se sustituye por la última copia que funcione.

Compilar desde el código fuente

Windows 10 u 11 y Rust estable con la toolchain x86_64-pc-windows-gnu o -msvc. El instalador es el mismo ejecutable: si se llama RGBTray-Setup-*.exe, se instala a sí mismo.

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

Ayuda a que ilumine más dispositivos

RGB Tray es gratuita y de código abierto. La ayuda más útil no necesita código: un informe de dispositivo, o probar una versión en hardware que el proyecto no tiene. Y una estrella en GitHub ayuda a que otras personas la encuentren.

Dar una estrella en GitHub Informar de un problema Solicitar un dispositivo

Los problemas y las solicitudes van a GitHub; para escribir allí hace falta una cuenta gratuita de GitHub.