AI1 0 1 1 0 1 0 0 1 1 0 10 1 0 0 1 1 0 1 0 1 1 0 1Ai Me Bro

LED reactive costume mask

A 3D-printed or foam mask with a small LED matrix that reacts to your voice or to nearby music, running official WLED or a short FastLED sketch on an ESP32. Built so you can still see and breathe.

IntermediateBuild time: 6-10 hours, plus about 10 hours of printingParts: $40-703D print
Illustration of LED reactive costume mask
Illustration. An artist's impression, not a photo of a finished build. Your build will look different.

Safety first

  • You must be able to see and breathe. Do not cover the eyes with LEDs or a dark tint, and do not wear a sealed mask for a long time.
  • Cap brightness so the matrix cannot shine into your eyes or someone else's at close range. Use a diffuser.
  • Power from a quality USB power bank, not a loose LiPo taped to your face. Carry a way to shut it off and to take the mask off quickly.
  • This is a costume, not protective equipment. Do not wear it while driving, cycling, or in a crowded mosh pit if it limits your vision.

Rules and laws

  • Some events and venues ban masks. Check the rules before you show up.
  • Do not use the mask to impersonate a real official or to hide your identity for a crime. This is a costume project.

Parts

PartQtyApprox. eachSubtotal
Espressif ESP32-DevKitC-32E (DevKitC V4) development boardThis is a full-size 38-pin DevKit and is bulky in a mask; it is the board this project already used. Official Espressif 38-pin DevKitC V4 with ESP32-WROOM-32E (4 MB). Micro-USB port, not USB-C. Buy only the official 38-pin Micro-USB board, not a USB-C or 30-pin clone. Primary listing: Mouser 356-ESP32-DEVKITC32E, $10.20, 1,701 in stock on Nov 12, 2026, per Findchips (https://www.findchips.com/search/ESP32-DEVKITC-32E). The Mouser US page itself returned 403 to a direct fetch, so click-confirm the US storefront before you order. Mouser Netherlands listed 1,622 in stock at €8.60 the same day. Do not use DigiKey as the default today (search snippets showed 0 in stock / long lead time). Official Amazon listing https://www.amazon.com/dp/B09MQJWQN2 was still unavailable; use it if it returns. Amazon search for the official board: https://www.amazon.com/s?k=ESP32-DevKitC-32E. Adafruit #3269 remains $15.00 and was out of stock (https://www.adafruit.com/product/3269). Typical $10-16.Mouser · price seen on 2026-11-121$10.20$10.20
WS2812B 8x8 (64 pixel) flexible LED matrix, 5 VSmall enough for the forehead or cheeks without covering the eye holes. Plan power at up to 60 mA per LED at full white and cap brightness. Typical $8-15, no verified link.Amazon (search)1$10$10
USB power bank, 5 V, quality pack with an obvious switchSize it for your LED count at a capped brightness. Typical $12-25, no verified link.Amazon (search)1$15$15
INMP441 I2S mic or another mic officially listed for your WLED buildTypical $3-8, no verified link.Amazon (search)1$5$5
Resistor, 330 ohm (220-470 ohm is fine)Typical a few cents to $0.40 in a small pack, no verified single-item link.Amazon (search)1$0.20$0.20
Electrolytic capacitor, 1000 uF, 10 V or higherTypical $0.50-1.50, no verified link.Amazon (search)1$0.80$0.80
Elastic, foam padding, and a quick-releaseTypical $3-8, no verified link.Amazon (search)1$5$5
Estimated total (parts only)$46.20

Typical US prices, checked 2026-11-12. Prices change and multi-packs are often cheaper per piece.

As an Amazon Associate I earn from qualifying purchases. Prices change; check the store.

Filament

PLA (1.75 mm): about 140 g (47 m), roughly 10 h of printing.

PLA for a rigid mask shell (PETG is tougher; TPU pads where it touches skin), 0.2 mm layers, 15-20% infill, 3 walls, supports for the face curve. Sand or pad any edge that will touch skin.

AI agents you'll use

Tools

  • 3D printer or EVA-foam tools
  • Soldering iron
  • Hot glue gun
  • Computer to flash the ESP32
  • Craft knife

What you'll learn

  • Mounting a small LED matrix in a wearable
  • Powering it from a USB power bank
  • Audio-reactive effects in official WLED, or a small FastLED sketch
  • Costume safety: vision, breathing, and heat

A mask with a small reactive LED panel is a party build, not a motorcycle helmet. The electronics are the same idea as the WLED wall art project, but the mechanical rules change: you have to see, breathe, and get the mask off in a hurry.

What you'll build

A printed or EVA-foam mask with a small matrix or strip on the forehead or cheeks - not over the eyes - an ESP32, and a USB power bank on a belt or in a pocket. Official WLED is the fastest way to get audio-reactive patterns.

Print the parts

Search Printables or Thingiverse for an open-licensed costume mask you can modify, or an "LED mask" file that already has eye openings, and credit the designer. Measure your face and the matrix before you slice. Print with the settings above, then pad the contact points with foam or TPU.

If a file blocks the eyes or has no ventilation, do not "fix it later with a drill" after it is on your head - recut the openings on the workbench first.

Wiring

From To
Power bank 5 V LED 5 V and, through a safe path, the ESP32 5 V (or power the ESP32 from a second USB port on the same bank)
Power bank GND LED GND and ESP32 GND
Capacitor Across 5 V and GND near the matrix
ESP32 data GPIO 330 ohm resistor, then the first LED DIN
Optional supported mic The pins in official WLED docs for that mic, not a guessed I2S map

Keep wires away from your eyes and use strain relief so a tug on the cable does not pull the mask into your face.

Step-by-step

  1. Fit a paper or rough printed mock-up and mark eye holes, breathing room, and where the matrix will sit.
  2. Print or cut the mask, sand and pad it, and confirm vision and a quick-release strap with the electronics still off the bench.
  3. Wire a short LED test at low brightness on the desk, then flash official WLED or a FastLED test sketch.
  4. Cap brightness, add a diffuser, and confirm the pattern cannot shine straight into your eyes in a mirror.
  5. Mount the power bank off the mask (belt or pocket), route a cable down, and add a physical power switch you can find with gloves.
  6. Wear it for a few minutes indoors, then take it off and feel for heat, pressure points, and fogged vision.
  7. Only then wear it at an event, and take a friend who knows how to help you get it off.

Code

Official WLED is the recommended path. Prompt:

Walk me through official WLED on an ESP32 for a small WS2812B matrix in a costume mask, including a low brightness cap and, if I add a mic, only a microphone that current WLED docs support.
Remind me not to cover the eye holes and not to power a large matrix from a loose LiPo on my face.

If you write a sketch instead, use official FastLED and keep the first program to a dim pulse.

Troubleshooting

  • Fogged view or short breath: more ventilation, shorter wear time, or a different form factor (a visor instead of a full face).
  • LEDs flicker when you walk: a loose USB cable or a power bank with aggressive auto-off. Use a bank that can stay on at low current.
  • Face gets hot: the matrix is too close, too bright, or there is no airflow. Reduce brightness and add a gap.
  • Audio-reactive does nothing: the mic is not supported, or the WLED audio build and pins do not match the official list.

Files, code and docs

Last checked 2026-11-12. Double-check parts against your own board and seller listings before you buy.

LED reactive costume mask: parts, filament and AI agents | Ai Me Bro