Skip to content
Boberek2005Public

About

Lightweight keyboard backlight control for Gigabyte AERO X16 on Windows — no Gigabyte Control Center needed.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

AeroLED

Lightweight keyboard backlight control for Gigabyte AERO X16 on Windows — no Gigabyte Control Center needed.

Unofficial project. AeroLED is not affiliated with, endorsed by, or supported by Gigabyte. "GIGABYTE" and "AERO" are trademarks of their respective owners.

AeroLED window

The problem

On the AERO X16 the keyboard backlight is normally controlled by Gigabyte Control Center (GCC). GCC is heavy, sometimes buggy, re-applies its own settings on boot and after sleep, and offers only a handful of options. Simply turning the backlight on or off is more hassle than it should be.

AeroLED is a small tray app that does just the backlight and nothing else.

Features

  • Color wheel: click or drag to pick any RGB color. The keyboard updates live.

  • Brightness: slider plus − / + buttons

  • Favorite colors: save up to 14 colors. Click one to apply it, right-click to remove it.

  • Rainbow mode: smooth hue cycle (one full cycle every 6 s), computed on the PC

  • Sleep timer: turn the backlight off for 10 / 20 / 30 / 60 minutes or any custom time. It comes back on by itself, e.g. while watching a 20-minute episode.

  • Tray icon with the same controls. Closing the window keeps the app in the tray.

  • Global hotkeys (no admin rights needed):

    Shortcut Action
    Ctrl+Alt+K backlight on / off (also cancels a running sleep timer)
    Ctrl+Alt+↑ / Ctrl+Alt+↓ brightness up / down
  • Remembers your settings and re-applies them on start and after wake from sleep

  • "Keep my settings" watchdog re-applies your color every 10 s, so nothing else can override it for long

  • Start with Windows option (tray menu). It starts silently in the tray.

  • Single instance: starting it again just brings up the existing window

  • On exit the keyboard stays in your last static color, or off if you turned it off

  • Very light: about 0.01 % CPU while the rainbow animation runs

  • English and Polish UI: switch with the EN / PL buttons in the top-right corner. The first start follows your Windows language.

Supported hardware

Confirmed
Laptop Gigabyte AERO X16
Keyboard USB ID 0414:8104, interface 4
Protocol Microsoft HID LampArray (usage page 0x59), product string GIGABYTE X15
Lighting 1 zone (the whole keyboard is one RGB lamp, 8 bits per channel)
Update rate tested at 10/20/30/60 FPS, no dropped frames (about 2 ms per update)

Check your model: in PowerShell (nothing to install):

Get-PnpDevice -PresentOnly | Where-Object InstanceId -match 'VID_0414' | Select-Object FriendlyName, InstanceId

Look for VID_0414&PID_8104. With Python installed you can get a full report:

python aero_led.py wykryj          # lists Gigabyte HID interfaces and the one AeroLED would use
python probe.py --bez-fps          # reads the LampArray descriptor and lamp layout (read-only, no blinking)

Other Gigabyte models (AERO, AORUS, G5/G6, …) may work if they expose a HID LampArray interface. If you try it, please open an issue with the output of the commands above. Reports of models that work are just as welcome as reports of ones that don't.

Install

Option 1: download the .exe

  1. Download AeroLED.exe from Releases.
  2. Run it. Windows SmartScreen may warn about an unsigned app: More info → Run anyway.
  3. In the tray menu tick "Start with Windows".

Option 2: run from Python

Requires Python 3.10+ (on install, tick "Add python.exe to PATH").

git clone https://github.com/Boberek2005/aeroled.git
cd aeroled
pip install -r requirements.txt
pythonw aero_led.py

pythonw aero_led.py --tray starts with the tray icon only. build.bat builds dist\AeroLED.exe yourself (runs the tests first). python test_aero_led.py runs the tests, which need no keyboard.

⚠ Turn off the things that fight over the backlight

Two other things can control the same LEDs. If they stay on, they and AeroLED keep overriding each other:

  1. GCC autostart: Task Manager → Startup apps → GIGABYTE Control Center → Disable. Don't uninstall GCC, because it installs drivers.
  2. Windows Dynamic Lighting: Settings → Personalization → Dynamic Lighting → turn off "Use Dynamic Lighting on my devices" (or turn it off just for this keyboard).

How it works

The AERO X16 keyboard exposes a standard Microsoft HID LampArray interface. AeroLED reads its report descriptor and uses three feature reports:

Report LampArray name Use
1 LampArrayAttributesReport read the lamp count (bytes 1–2, little endian)
6 LampArrayControlReport [6, 0]: turn off autonomous mode, so the host controls the lamps
5 LampRangeUpdateReport [5, 1, start_lo, start_hi, end_lo, end_hi, R, G, B, 255]: set a color for a lamp range

The device also declares the standard attribute request/response (2/3) and multi-update (4) reports. Since there is only one lamp, AeroLED doesn't need them. Effects such as the rainbow are computed on the PC and sent as plain colors over one open connection, and only when the color actually changes.

What AeroLED deliberately does not use: the same USB device also has vendor-specific interfaces (0xFF01 on interface 3, 0xFF00 on interface 1). That is Gigabyte's own channel, used by GCC for firmware-driven animations, and those animation programs are known to be able to hang the keyboard firmware. AeroLED never opens these interfaces, and the test suite fails if anything tries to.

Safety / disclaimer

  • Use at your own risk. The software is provided "as is", without warranty (see LICENSE).
  • AeroLED sends only the standard HID LampArray reports listed above, the same kind Windows Dynamic Lighting uses.
  • No firmware flashing, no BIOS/EC/ACPI access, no fan control, no admin rights required.
  • The optional sleep timer and watchdog only send colors and don't touch anything else.

Credits

The reverse-engineering groundwork by these projects made AeroLED possible:

FAQ

Why no per-key RGB / waves / reactive typing? The hardware doesn't support it. The AERO X16 keyboard reports exactly one lamp (LampCount = 1), so the whole keyboard always shows one color. Per-key effects are impossible on this model. AeroLED does what one zone can do well: any color, brightness, rainbow, timer.

Does it conflict with Gigabyte Control Center? Yes, if both run. Disable GCC autostart (see above). The watchdog wins after a few seconds anyway.

Where are the settings stored? %APPDATA%\AeroLED\config.json. Delete it to reset.

The colors keep changing back. Windows Dynamic Lighting or GCC is running. See Turn off the things that fight over the backlight above.

License

MIT © 2026 Bartosz Kaczmarczyk


🇵🇱 Po polsku

AeroLED to lekki program do podświetlenia klawiatury Gigabyte AERO X16 na Windowsie, bez Gigabyte Control Center. Nieoficjalny, niezwiązany z firmą Gigabyte. Zrobiony w Polsce. 🇵🇱

AeroLED po polsku

  • Interfejs po polsku i po angielsku: przełącznik PL (z flagą) / EN w prawym górnym rogu.
  • Koło kolorów, jasność, ulubione kolory, tryb tęczy, wyłączanie na czas (np. na 20 minut).
  • Ikonka w zasobniku, skróty Ctrl+Alt+K (wł/wył) i Ctrl+Alt+↑/↓ (jasność), autostart.
  • Instalacja: pobierz AeroLED.exe z Releases albo uruchom INSTALUJ.bat (wersja z Pythonem).
  • Ważne: wyłącz autostart GCC (Menedżer zadań → Aplikacje autostartu) oraz Oświetlenie dynamiczne Windowsa (Ustawienia → Personalizacja → Oświetlenie dynamiczne), inaczej będą nadpisywać kolory.
  • Klawiatura ma jedną strefę, więc efekty per klawisz nie są możliwe.
  • Program używa wyłącznie standardowego interfejsu HID LampArray. Nigdy nie wysyła nic na kanał producenta (0xFF01), niczego nie flashuje. Używasz na własną odpowiedzialność.

About

Lightweight keyboard backlight control for Gigabyte AERO X16 on Windows — no Gigabyte Control Center needed.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages