Lumino — Smart LED Piano

Lumino is a full DIY smart piano lighting system that syncs a physical WS2812B LED strip with your MIDI keyboard in real-time — entirely from the browser, no app required.

Every key you press lights up the LED strip with its corresponding color and velocity-mapped brightness. Release a sustained key and the LEDs gracefully fade over 4 seconds, mimicking real piano string decay. It runs fully standalone via Chrome's Web MIDI + Web Serial APIs, talking directly to the ESP32 over USB at 1 Mbaud using the Adalight protocol.

Live demo: nipunarora8.github.io/the-piano-project (works on Chrome)

What's included in this print: A keyboard stand riser/mount I designed to elevate the keyboard for a cleaner setup while playing and viewing the LED feedback.

✦ Learning Mode

Lumino's built-in Learning Mode turns your LED strip into a light guide. Upcoming notes pulse on the physical keys before you play them — white for white keys, warm orange for black keys. The engine uses "wait-to-advance" logic, meaning it won't move on until you actually play the note, so it matches your pace perfectly. Mistakes are highlighted. Legato, fast runs, repeated notes — all handled. Drop in any .mid file and it becomes a playable lesson instantly. It's the closest thing to having a teacher built into your piano.

Full project features:

• Real-time LED sync to MIDI input (velocity-mapped brightness + color)

• 8 curated colormaps: Rainbow, Ocean, Fire, Synthwave, Cyberpunk, Forest, Crimson, Pure Gold

• Interactive Learning Mode with step-timeline and "wait-to-advance" logic

• Built-in songs + drag-and-drop .mid file import

• Demo/autopilot mode

• Spectrum analyzer waveform display

• Acoustic sustain simulation (MIDI CC 64)

• No backend server needed — runs entirely in Chrome

Hardware you'll need:

• ESP32 (any standard dev board)

• 1m WS2812B strip, 74 LEDs/m (62 actively mapped to 61 keys, E5 spans two LEDs)

• MIDI keyboard (designed around M-Audio Keystation 61 MK3, but any 61-key USB MIDI keyboard works)

• USB cable

Flash the included Adalight sketch onto your ESP32, open the HTML file in Chrome, and you're running.

Full source code and documentation: github.com/nipunarora8/the-piano-project