RGB Tray
Бесплатно Открытый код Windows 10 / 11

RGB Tray

Вся RGB-подсветка — из одного маленького приложения в трее.

RGB Tray управляет клавиатурами, мышами и лампами напрямую по HID, а лампами Tuya — по вашей локальной сети. Цвет, эффект и яркость сразу для всего или для каждого устройства отдельно, и никаких фирменных программ в фоне.

Скачать для Windows Добавить своё устройство

Вместо G HUB Synapse Armoury Crate SignalRGB

Панель RGB Tray: цвет и эффект для всех устройств, общая яркость и карточка каждого устройства

01

Зачем одно маленькое приложение

У каждого бренда своя программа подсветки, и каждая хочет работать в фоне. RGB Tray берёт подсветку всех этих устройств на себя.

  • Ничего лишнего в фоне

    Приложение само говорит на протоколе каждого устройства, поэтому G HUB, Synapse, Armoury Crate и SignalRGB запускать не нужно. Для установки не нужны права администратора.

  • Одна панель для всего

    Щелчок по значку в трее открывает панель: цвет, эффект и яркость сразу для всех устройств или для каждого, и пресеты на глобальных горячих клавишах.

  • Успевает за компьютером

    Подсветка возвращается после сна (и Modern Standby) и при подключении устройства, притухает вместе с экраном и гаснет, пока экран выключен.

02

Поддерживаемые устройства

Сейчас — шесть семейств. Другие модели с теми же протоколами тоже могут заработать, а новую часто можно добавить небольшим текстовым файлом.

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

Клавиатуры ноутбуков (Aura)

Статичный, дыхание, спектр и выкл.; зоны клавиатуры и лампы корпуса через LampArray. После пробуждения клавиатура сама сбрасывается в белый, поэтому подсветка применяется заново.

QMK / VIA

Geekboard MacroPad v2, Keychron, самодельные

Любая клавиатура QMK с VIA и RGB: статичный, дыхание, спектр, выкл. и яркость. Цвета задаются только в RAM, так что сохранённые настройки самой клавиатуры не меняются.

Динамическое освещение Windows

Устройства HID LampArray

Устройства со стандартом LampArray: статичный, дыхание, спектр и выкл., с зонами из описания самого устройства. Дыхание и спектр рисует приложение.

Лампы Tuya

Wi-Fi-лампы в Smart Life, например LINUS A60

По локальной сети: цвет, белый с оттенком, дыхание, спектр и выкл. Лампа не гаснет вместе с экраном. Нужен локальный ключ лампы, его один раз получают из облака Tuya.

Подключение, все модели Razer и как получить ключ лампы Tuya — в полной таблице устройств на GitHub.

03

Что умеет

Маленькое, но не голое: всё то, ради чего обычно открывают фирменную программу.

  • Яркость и скорость

    Общая яркость и яркость каждого устройства поверх неё; скорость дыхания и спектра — общая и для каждого устройства.

  • Цвета клавиш

    Для клавиатуры Logitech: кисть, пипетка, радуга, двухцветный градиент, WASD и «только буквы», подсветка слова, сохранённые схемы, раскладки ANSI и ISO.

  • Пресеты на горячих клавишах

    Сохраните вид и переключайтесь на него глобальной горячей клавишей, в том числе F13–F24 с Ctrl, Alt, Shift или Win.

  • Горячая клавиша для устройства

    Выключает одно устройство и включает обратно как было — например, лампу в комнате. Пресеты от этого не меняются.

  • Следует за экраном

    Притухает, когда Windows затемняет экран, и гаснет, пока экран выключен: простой, блокировка или сон. Можно отключить.

  • Беспроводные и батарея

    Заряд батареи, оповещения при 10% и 5% и статус «Нет связи», пока беспроводное устройство спит; при пробуждении цвета возвращаются.

  • Много устройств, у каждого своё

    У одинаковых устройств свои настройки: они различаются по серийному номеру. Отключённые ждут в архиве вместе с настройками.

  • Делитесь настройками

    Экспорт и импорт всех настроек или один пресет в файл: он достаётся устройствам получателя тех же моделей.

  • Обновления в один щелчок

    Раз в день приложение спрашивает у GitHub последний релиз и показывает карточку, которая его ставит. Проверку можно отключить.

  • Свой в Windows

    Значок в трее показывает текущий цвет, панель можно закрепить поверх окон, тема следует за Windows, интерфейс — на русском или английском.

04

Как это выглядит

Панель в тёмной и светлой теме и окно «Цвета клавиш» для Logitech G915 TKL. Нажмите, чтобы увеличить.

Панель в тёмной теме с карточками устройств
Панель, тёмная тема
Панель в светлой теме с карточками устройств
Панель, светлая тема
Окно «Цвета клавиш»: раскладка клавиатуры, кисть и пресеты
«Цвета клавиш»: кисть, пипетка, градиенты, пресеты и эффекты прошивки

05

Чего оно не делает

Стоит знать, прежде чем что-то удалять.

  • Только Windows. Это приложение для Windows 10 и 11; версий для macOS и Linux нет.
  • Только подсветка. Никаких макросов, переназначения клавиш, DPI мыши и обновлений прошивки.
  • Не вместе с фирменными программами подсветки. Две программы, пишущие в одно устройство, мешают друг другу: сначала закройте подсветку G HUB, Synapse, Armoury Crate, SignalRGB или OpenRGB.
  • Без аккаунта и облака. В сеть приложение ходит только за ежедневной проверкой обновлений (её можно отключить) и к лампам Tuya в вашей собственной сети.
  • Не каждая модель проверена. Большинство моделей Razer взяты из данных OpenRazer и не проверялись; беспроводные клавиатуры HyperSpeed пока работают только по кабелю.
  • Пока без подписи кода. При первом запуске установщика SmartScreen может показать предупреждение; см. «Скачать» ниже.

06

Вашего устройства нет в списке? Добавьте его сами

Многим устройствам код вообще не нужен — только небольшой файл профиля. А с Claude Code не нужно знать ни Rust, ни HID: техническую работу делает Claude, вы смотрите на подсветку.

С Claude Code: /add-device

В репозитории есть навык /add-device для Claude Code. С ним Claude проходит путь от отчёта об устройствах до проверенного профиля или драйвера — и до pull request'а, если захотите.

  1. Откройте репозиторий в Claude Code

    На компьютере с Windows, к которому подключено устройство, склонируйте github.com/Gronck2/rgb-tray и запустите Claude Code в этой папке. Для профиля хватит инструментов командной строки установленного приложения; для драйвера нужен Rust, и Claude поможет его поставить.

  2. Наберите /add-device

    Скажите, что это за устройство и что на нём светится. Сначала закройте фирменную программу, чтобы две программы не спорили за устройство.

  3. Claude читает отчёт об устройствах

    Он запускает rgbtray --diagnose, находит ваше устройство по идентификаторам производителя и продукта и смотрит, какие из его интерфейсов говорят на уже знакомом RGB Tray протоколе.

  4. Находит протокол

    В OpenRGB или OpenRazer, в записи USB-обмена фирменной программы, которую сделаете вы (как), или осторожными пробами через --hid-send — по одной и только с вашего согласия.

  5. Вы — его глаза

    Он пишет профиль, проверяет его через --profile-check и проигрывает цвета, зоны и эффекты через --profile-test. После каждого шага спрашивает, что сделало устройство.

  6. Работает у вас

    Claude копирует профиль в %APPDATA%\rgbtray\devices\; перезапустите RGB Tray, и у устройства появится карточка на панели. Потом он спросит, хотите ли вы поделиться им.

Claude не видит подсветку, поэтому ничего не считается работающим, пока вы не скажете. Он никогда не отправляет команды обновления прошивки, загрузчика, сброса к заводским настройкам и записи во флеш, а перед отправкой любого придуманного им отчёта спрашивает разрешения. Если устройство перестало отвечать, отключите его и подключите снова.

Четыре пути, от самого простого

С Claude или вручную, устройство идёт первым подходящим путём.

  1. 1

    Уже работает

    Устройствами HID LampArray и клавиатурами QMK с VIA управляют общие драйверы. Откройте панель и найдите карточку.

  2. 2

    Профиль для знакомого протокола

    Новая модель Razer — небольшой TOML-файл с её идентификаторами продукта, transaction id и номерами светодиодов из OpenRazer. Профиль QMK/VIA может назвать эффекты прошивки.

  3. 3

    Профиль [hid]

    Простой протокол — отчёты с цветом внутри, без ответов устройства — записывается шаблонами отчётов с {r} {g} {b}. Умеет контрольные суммы XOR и суммой, отчёты «взять управление» и «вернуть», цвета отдельных светодиодов. Без компиляции.

  4. 4

    Драйвер на Rust

    Протокол, которому нужны ответы, рукопожатие или состояние, — это драйвер: модуль, реализующий трейт Device. Как его написать, рассказывает CONTRIBUTING.ru.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.ru.md.

07

Скачать и установить

Один файл: установщик — это само приложение. Ни среды выполнения, ни прав администратора.

RGBTray-Setup-x.y.z.exe

  1. Скачайте RGBTray-Setup-<версия>.exe из последнего релиза.
  2. Запустите. Приложение установится для вашего пользователя Windows в %LOCALAPPDATA%\Programs\RGB Tray и запустится.
  3. Щелчок по значку в трее открывает панель. Удаляется RGB Tray в Параметрах Windows → Приложения.
Скачать для Windows Все релизы

SmartScreen может предупредить при первом запуске. Установщик пока не подписан: нажмите «Подробнее» → «Выполнить в любом случае». В каждом релизе указан SHA-256 установщика.

Закройте фирменные программы подсветки. Две программы, пишущие в одно устройство, мешают друг другу. В Windows 11 служба «Logitech LampArray» (динамическое освещение) заставляет G915 игнорировать эффекты; RGB Tray предупредит об этом и предложит её отключить.

Настройки не потеряются. Они хранятся в %APPDATA%\rgbtray и сохраняются при обновлении и переустановке. В backups лежат копии за последние 14 дней и перед каждым обновлением, а повреждённый файл настроек заменяется последней рабочей копией.

Сборка из исходников

Windows 10 или 11 и стабильный 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 помогает другим найти приложение.

Звезда на GitHub Сообщить о проблеме Запросить устройство

Задачи и запросы — на GitHub; чтобы писать там, нужен бесплатный аккаунт GitHub.