Skip to content

TH108 (Epomaker TH108 V2 PRO) Live Lighting Controller v1.0.0

Latest
Latest

Choose a tag to compare

View all tags
@BeyondSmash BeyondSmash released this 28 Aug 07:15
· 21 commits to master since this release
v1.0.0
3d387a8

TH108 Live Lighting Controller v1.0.0

Host-driven, per-key RGB for the Epomaker TH108 V2 PRO over WebHID — no firmware mod, no vendor software. Its signature trick is something the stock firmware can't do: it composites a stack of live layers every frame and streams the combined per-key result to the board ~30–60×/second.

Highlights

  • Multi-layer compositor — up to 8 layers (background, reactive, gradient, pattern, per-key, audio, media/GIF, agent), each with its own blend mode and opacity.
  • Reactive typing in any app — the daemon's system-wide key hook lights keys you press anywhere, not just the browser tab.
  • Audio-reactive lighting — spectrum bars/effects from system audio, a specific app, a browser tab, or the mic.
  • GIF → keys — play a GIF across the board as a blended layer or standalone.
  • LCD screen — upload an image/GIF, or show now-playing (title/artist + a song-progress bar on the number keys).
  • Hotkeys & host actions — remap keys to lighting functions, or bind keys/chords to background actions (mic mute, launch, profile switch, window mgmt, macros).
  • Profiles — lighting/hotkey/global, with live switching, cycling, and per-app auto-switch.
  • Always-on daemon — login-autostart, tray control, and automatic USB-wedge recovery.
  • 18-language UI with right-to-left support.

Install (Windows)

Requires: Windows 10/11 · a Chromium browser (Chrome/Edge/Brave) · Node.js LTS.

  1. Download Source code (zip) below and unzip it.
  2. Double-click setup.cmd — installs dependencies, enables login-autostart, adds a Start-menu shortcut, and opens the controller at http://localhost:8123/.
  3. Click Connect Keyboard once and pick your board.

Full docs, protocol notes, and uninstall steps are in the README. Live demo (no daemon): https://beyondsmash.github.io/th108-suite/

Compatibility

✅ Verified on the Epomaker TH108 V2 PRO (the only hardware tested). Other 0x0C45 / SONiX-family boards may work partially but need a re-captured LED map. Chromium only — WebHID isn't in Firefox/Safari.

Legal

Independent interoperability project; protocol documented clean-room from observed behavior. No vendor firmware, software, or assets are included. Not affiliated with or endorsed by Epomaker. MIT licensed.

Assets 2
Loading