Wearable LED mask with an irregular matrix

Oct 11, 2026 Last reply: 2 hours ago 3 Replies
Jump to replies (3)

The detail that caught me off guard is how the LEDs trace a human face. Forehead, cheeks, nose and chin each get their own contours. In my view that makes the mask read as a face before a single pattern even plays, which is a far cry from the flat grids most matrix projects settle for.



The maker set out to show that programming a non-rectangular matrix is no harder than a rectangular one, and the build backs that claim up. The tutorial covers the XY mapper tool for handling irregular layouts, and the mask code leans on fadetoblackby and nblendPaletteTowardPalette for the effects. The code is available, and its comments credit where each displayed pattern came from, which strikes me as a classy touch.



On the results side, the mask runs a circle animation plus a sound-reactive mode. The maker chose to publish sooner rather than keep polishing that sound-reactive mode further. To my eye, that leaves the sound-reactive side as the one part still open to refinement.



One thing worth flagging: the metadata and description attached to the tutorial cover a separate ESP32 LED matrix project, not the mask. Anyone hunting for mask specifics would do better to lean on the code comments and the XY mapper explanation instead.



Project by Scott Marley. Watch it on their YouTube channel:

formatting link


Releasing the tutorial before the sound-reactive mode was fully polished seems like a smart call to me. The central lesson, that irregular matrices are no harder than rectangular ones, does not depend on that mode being perfect, and the circle animation already shows the mapping working. I would rather have the method out in the open than wait on extra effects.

How does the maker keep the LED order straight once the matrix stops being rectangular? The XY mapper explanation covers the addressing side, but I am curious how the physical positions on the face get tied to those coordinates, especially around the nose where the contours get tight.

I would love to see a flicker animation from another project tried on this mask. The maker has joked it might be too intense but likes its patterns. On a face-shaped canvas a flicker seems like it could look striking, particularly across the cheek contours, and it would be a quick experiment next to the existing modes.

Join the Discussion

Have something to add? Share your thoughts — no account required.

Didn't find your answer?

Ask the community — no account required