KACHANG·SIA
SYSTEM OK
Home  /  Blog  /  DIY Wedding Lighting with ESP8266

DIY Wedding Lighting with ESP8266 — A Field-Tested Guide

You're planning a wedding on a budget. The lighting companies want $500–1500 for the evening. You have an ESP8266, a soldering iron, and a free weekend. This guide is what I'd build for you — four pre-programmed scenes (ceremony, dinner, dance floor, exit), a 12V relay-controlled rig, AP-mode fallback so the show continues even if venue WiFi dies, and a 24-hour pre-event test protocol that catches every failure mode I've seen in real jobs.

// WHAT WEDDING LIGHTING NEEDS

The four scenes every wedding needs.

Wedding lighting isn't about effects. It's about scenes. Pre-programmed looks that the host can switch between with a single tap, so nobody is fiddling with a phone mid-vows or during the first dance. The four scenes below cover the whole evening.

CEREMONY

Warm single colour (around 2700K amber), low brightness ~30%, no animations. Quiet, dignified, photo-friendly. Lights the aisle and the altar zone — not the dance floor.

DINNER

Soft warm white or amber, brightness ~40%. Lights the dining tables for conversation and food. Subtle, not moody. Often the longest scene of the night.

DANCE FLOOR

Full RGB or warm-amber wash, brightness 70–100%. Pair with the DJ's lighting plan or run a slow colour cycle. The "energy" scene — turn it up for the band's set.

EXIT / SEND-OFF

Slow colour chase, sparkle effect, or fade-to-warm. Marks the couple's send-off. Often paired with sparklers or a confetti moment — the lighting supports the photo op.

Save each scene as a preset in your controller firmware before the event. The host's job on the day is: tap a button at the right moment. That's it.

// THE BUILD

Parts and budget for a 4-zone rig.

Typical small-to-mid venue — a function room or tent for ~80 guests. Sized for 4 zones of 12V LED uplighting.

PartCostWhat to look for
ESP8266 board (NodeMCU v2/v3 or Wemos D1 mini)$4–6Either works. Wemos D1 mini is tidier for a permanent install in a small enclosure.
4-channel relay module (active-low, 5V coil)$3–5The classic blue 5V 4-channel board — drives 4 zones of 12V fixtures.
4× 12V LED uplighters (RGB or warm-white)$40–80Off-the-shelf 12V uplighters from a hardware store work fine. Avoid cheap "smart" ones — you want dumb fixtures the relay can switch.
12V power supply (sized to uplighters)$10–25Meanwell or similar. Size for total wattage × 1.2 (e.g. 4× 24W = 96W → 12V 10A supply).
Enclosure (waterproof if outdoor)$5–15A junction box from the hardware store. For tents / outdoor venues, get an IP65-rated box.
Cable ties, weatherproof connectors, 18 AWG wire$5–10For tent pole routing and waterproof joins. Silicone wire is the easiest to work with.
Phone charger (5V 1A) for the ESP8266$3–6USB power for the controller. Cheap and replaceable.

Realistic total: $80–150 in parts for a 4-zone DIY rig, vs $500–1500 quoted by a lighting rental. The savings are real; the catch is that you're doing the wiring yourself.

// OUTDOOR WIRING

Tents and outdoor venues — what to do differently.

Outdoor weddings add three constraints the indoor version doesn't have: weather, cable runs, and venue rules. Each one needs planning.

  • Run 12V, not mains, everywhere visible. Most outdoor venues have strict rules about AC mains inside tents — the venue's electrician needs to do that work, with insurance and permits. Your DIY controller runs 12V DC, which is safe to run yourself inside a tent.
  • Use weatherproof enclosures and connectors. Any outdoor splice or relay box needs IP65 or better. A $4 junction box from the hardware store plus a gasket is enough for the controller; for uplighters, look for ones rated IP65 from the start.
  • Cable-route along tent poles. Use cable ties and adhesive mounts. Never let 12V wiring lie across walkways — guests trip, cables get yanked.
  • Keep the controller out of direct sun. A black enclosure in 35°C sun will cook. Mount it under a table, inside a shaded spot, or wrap it in reflective tape.
  • Bring a backup 12V supply. Power supplies fail. A spare $15 unit in the boot of the car has saved at least one wedding I've worked on.
// PRE-EVENT TEST

The 24-hour pre-event test protocol.

This is the most important part of the whole build. The rig should be powered up and left running at least 24 hours before the wedding. Anything that's going to fail will usually fail in that window — and you'd rather find it at home than at the venue.

The checklist I run through for every event job:

  1. Power up the full rig (ESP8266 + relay + all uplighters + phone charger) and let it idle for 24 hours.
  2. Cycle through every scene every 2 hours — does each relay click and each zone light up?
  3. Disconnect from the home WiFi mid-cycle — does the AP fallback kick in?
  4. Walk the phone out of range, then back — does it reconnect cleanly?
  5. Power cycle the relay module 5 times in a row — does the ESP8266 come back?
  6. Smell-test the power supply after 12 hours — any burning, any warmth beyond normal?
  7. Check every wire joint — are screw terminals still tight after thermal cycling?
  8. Verify the venue's WiFi (if any) is on a network your phone can join, or plan to use AP-only.

If everything passes, you can pack the rig into the car the morning of the wedding with confidence.

// HONEST BOUNDARIES

What not to DIY.

I'm an electronics builder, not an electrician. Wedding venues are real buildings with real electrical codes, fire safety rules, and insurance requirements. Here's where I draw the line, and where you should hire a professional.

Don't DIY mains-voltage wiring

Anything over 12V DC at the wedding — running a feed from the venue's distribution board, installing mains-rated chandeliers, running outdoor mains cables — is licensed-electrician work in most jurisdictions. The risks aren't theoretical: a miswired mains junction is a fire hazard and an insurance problem.

Don't skip venue permits

Many venues require electrical sign-off before a wedding — even for low-voltage lighting. Check with the venue coordinator before you show up with your own rig.

Don't run lighting near walkways in tape

A loose cable across a dance floor or aisle is a trip hazard. Use proper cable covers if any wiring has to cross a guest path.

Don't use undersized wire for the load

4 uplighters × 24W = 96W at 12V = 8A. Use 18 AWG or thicker for the main 12V runs; thinner wire gets hot and is a fire risk over distance.

The boundary I keep for myself: I wire 12V DC lighting for weddings and leave mains, distribution boards, and venue infrastructure to licensed electricians. That's not me being cautious — it's the right call for the couple's safety and the venue's insurance.

// SKIP THE TRIAL AND ERROR

Pre-built scenes, ready to flash.

The Kachang Sia Event Lighting Control pack was built for exactly this — 4-zone scene presets (ceremony, dinner, dance floor, exit) and a $19 download that skips the months of trial and error. See the ESP8266 Event Lighting Pack for $19.

👉 See the ESP8266 Event Lighting Pack ($19)
// FAQ

Quick answers before you commit.

Can I DIY wedding lighting with an ESP8266?

Yes for 12V LED uplighting, accent strips, and fairy-light zones. An ESP8266 + 4-channel relay module can switch up to four zones of 12V DC lighting — ceremony, dinner, dance floor, exit — from a phone. For anything that involves AC mains wiring, hire a licensed electrician.

How much does DIY ESP8266 wedding lighting cost?

In my experience, a 4-zone DIY rig with the controller, four 12V LED uplighters, a power supply, and weatherproof wiring lands around $80–150 in parts for a small-to-mid-sized venue. Compared to a rental quote of $500–1500 for the same zones, it's a meaningful saving.

What if the venue WiFi fails during the wedding?

Use AP mode as the primary control method. The ESP8266 makes its own WiFi network — the host's phone connects directly to it, no internet, no venue router. If the venue WiFi drops mid-event, AP mode keeps working. The Kachang Sia pack supports AP+WiFi dual mode with auto-fallback.

Can I run AC mains lighting (like chandeliers) from an ESP8266?

Technically yes with a suitable relay rated for mains — but this is where I draw the line and recommend a licensed electrician. I'm not an electrician. Wedding venues have strict electrical regulations; mains wiring mistakes create real fire and shock hazards. Keep your DIY to 12V DC and hire a pro for anything else.

// ABOUT THE AUTHOR

Who wrote this guide.

👷

About the author: Jack Loh is an electronics & coding builder based in Singapore. He builds ESP8266 controllers for real event jobs — weddings, parties, exhibitions — and sells the firmware and wiring guides from his own builds.

This page is written from the same builds. The scene lists, wiring tips, and 24-hour test protocol above are the ones he runs at every job — practical, not textbook.