WLED New Year Holiday Countdown Timers WLED Max How-To

WLED New Year's Eve: a Midnight Countdown, Fireworks Effects and a Preset at 00:00

Make WLED count down to midnight and switch to fireworks at 00:00 with Countdown Mode and the Countdown-Over preset. Effect settings and a presets file.

By

Quick answer: WLED has a countdown built in. In Config›Time & Macros, set Countdown Goal to 2027-01-01 at 00:00:00 and put the number of your fireworks preset in Countdown-Over Preset. The light switches to that preset one second into the new year. Tick Countdown Mode as well and WLED draws a bar that fills toward midnight, or shows the time left as text on a matrix.

Everything here runs on the light itself, so it works with the phone in your pocket and the router busy with everyone’s videos. It works on WLED 0.14, 0.15 and 16.

Before you start: the clock

The countdown is only as good as the light’s clock. On the same Time & Macros page:

  • Get time from NTP server has to be ticked. Without internet time the light doesn’t know it’s December 31.
  • Time zone must be yours. The goal is read in the light’s local time, so a light left on UTC fires at 7 pm in New York.
  • Check the line Current local time is under the time zone. If it shows the right time to the second, you’re set.

Lights that spend the day switched off at a smart plug come back with no time until they reach the NTP server again, which usually takes a few seconds after Wi-Fi connects.

Switch to fireworks at midnight

  1. Build the midnight look and save it as a preset. A fireworks effect at full brightness is the obvious choice (settings below), or load our presets file and use preset 6, Midnight.
  2. Open Config, Time & Macros. Under Countdown Goal, enter the date as 2027-01-01 (the year field only takes the last two digits) and the time as 00:00:00.
  3. Further down (under Timer & Alexa Presets on WLED 16, Macro presets on 0.14 and 0.15), enter the preset number in Countdown-Over Preset.
  4. Click Save.

That’s all. When the goal passes, WLED applies the preset once. It doesn’t need Countdown Mode to be ticked for this.

Two things to know. The preset doesn’t stay a one-off: after the goal has passed, WLED runs it again whenever the light restarts and each time it refreshes its internet time (about twice a day). So on January 1, set Countdown-Over Preset back to 0. And with UDP sync sending turned on, the other lights in your sync group follow the midnight preset like any other change (how sync works). Without sync, set the same goal and preset on every controller. They all keep NTP time, so they switch within about a second of each other.

In the app, Enable Countdown saves the goal and the preset, which is the part that fires at midnight. The countdown bar and text below are set in the web UI.

Or use a timer

A regular timer does the same job to the minute: hour 0, minute 0, the calendar icon set to January 1 through January 1, and your midnight preset. Timers have one advantage. They don’t care how the countdown fields are set, so you can also add a 00:30 timer that goes back to the show and a 01:30 timer that turns the lights off. Steps in WLED timers and date ranges.

A countdown you can see

On a strip: the countdown bar

Countdown Mode turns WLED’s clock overlay into a bar. Under Clock on Time & Macros:

  1. Tick Analog Clock overlay.
  2. First LED and Last LED: the range the bar may use, for example 0 and 99. Keep it to 255 LEDs or fewer; the bar’s LED count is stored in one byte and wraps around past 255.
  3. 12h LED: where the bar starts, usually the same as First LED.
  4. On 0.15 and 16, leave Show clock overlay only if all LEDs are solid black unticked, or the bar only shows over a black strip.
  5. Tick Countdown Mode and save.

The bar is drawn in color 2 of the main segment, over whatever effect is running. Set color 2 to white or gold and pick a calm effect underneath, like Solid or Breathe in dark blue, so the bar reads from across the room.

How far the bar is filled depends on the time left, and it starts over at each step:

Time leftThe bar shows
1 to 7 daysProgress through the last week
1 to 24 hoursProgress through the last day
1 to 60 minutesProgress through the last hour: empty at 23:00, nearly full at 23:59
Last 60 secondsEmpty at 23:59:00, then fills one step at a time until midnight

That last minute is the moment people watch. On a 60 LED range the bar grows by one LED per second.

On a matrix: the time left as text

On a 2D matrix, the Scrolling Text effect (ID 122) shows the segment’s name, and a few name tokens are replaced with the time. With Countdown Mode ticked, WLED’s clock counts the time left instead, so:

  1. Tick Use 24h format on Time & Macros (in 12 hour mode the last hour shows as 12 and the seconds are replaced by AM or PM).
  2. Name the segment #TIME. WLED shows the time left as hours, minutes and seconds, like 0:04:59.
  3. Set the font size and speed to taste. A segment named with text only, like HAPPY 2027, works for after midnight.

Hours past 24 wrap around, so switch Countdown Mode on in the evening. After midnight the same text counts up from zero. Turn Countdown Mode off on January 1: while it’s on, everything on the light that shows the time shows the countdown instead.

If your matrix isn’t set up yet, the 2D matrix guide covers panels, serpentine wiring and testing with Scrolling Text.

Effects for New Year’s Eve

Fireworks are the obvious theme, and WLED has several. Sliders go from 0 to 255; the numbers are starting points.

Effect (ID)Colors or paletteSlidersWhat you get
Fireworks (42)Palette Rainbow, color 2 blackFrequency 192Colored bursts that pop up anywhere and fade
Fireworks Starburst (89)Palette Rainbow, color 2 blackChance 150, Fragments 128Bursts that throw sparks both ways along the strip
Fireworks 1D (90)Palette Rainbow, color 2 blackGravity 128, Firing side 128A rocket climbs, explodes and the sparks fall back. Best on a vertical run or a window frame
Solid Glitter (103)Color 1 gold FFB400, color 3 whiteIntensity 96Gold with white glitter. Good for the hours before midnight
Sparkle Dark (21)Color 1 gold, color 2 whiteSpeed 200, Intensity 160Gold with quick white flashes
PS Fireworks 1D (205)Palette of your choiceDefaultsWLED 16 only: particle fireworks with trails
PS Fireworks (189)Palette of your choiceDefaultsWLED 16 on ESP32, 2D matrices only: rockets launched from the bottom

The PS (particle system) effects are new in WLED 16. ESP32 builds have both kinds; the regular ESP8266 build has the 1D ones only, and the small ESP01 and ESP02 builds have none. On 0.14 and 0.15 use the first five.

Gold and white read as New Year’s Eve on LEDs. Gold FFB400 (255, 180, 0) looks right on most strips; the screen gold FFD700 tends to look lemon yellow on a strip. On RGBW strips, mix in the white channel for a softer champagne white.

A pattern for the evening

For the hours before midnight, a steady pattern often looks better from the street than fireworks. Two gold LEDs and one white, repeating, is Solid Pattern (83) with color 1 gold, color 2 white, Speed 1 and Intensity 0 (the trick is explained in the 2 red, 1 white guide).

In WLED Max on iOS and Android, Pattern Maker has a New Year’s Eve template: 2 gold, 1 cool white, with a fast Sparkle. It is the first template from December 26 to January 1. Open a light on the Control tab, tap Make a Pattern, pick the template and save it as a preset. Details in Christmas patterns and Pattern Maker.

Download the New Year presets

wled-new-year-presets.json is a WLED presets file with the looks from this page:

SlotPresetEffect
1Gold glitterSolid Glitter, gold with white
2Gold and white sparkleSparkle Dark
3FireworksFireworks, Rainbow palette
4Fireworks StarburstFireworks Starburst
5Fireworks 1DFireworks 1D
6MidnightFireworks Starburst, more bursts, full brightness
7New Year showPlaylist of 1 to 5, one minute each
8OffTurns the light off, for timers

Load it in Config > Security & Updates, Restore presets. Then enter 6 as the Countdown-Over Preset, and point an evening timer at 7.

Before you restore

Restoring replaces every preset and playlist on the light. Click Backup presets first, or paste single presets instead. How to back up and restore.

The presets change only the first segment and don’t store start and stop, so they fit any strip length. Only Midnight sets brightness (to full). WLED’s brightness limiter still applies, so a correct Maximum PSU Current keeps the power supply safe (settings explained).

To paste just the midnight look, tap + Preset in the web UI, untick Use current state and paste this into API command:

{"on":true,"bri":255,"seg":[{"id":0,"fx":89,"sx":255,"ix":200,"pal":11,"col":[[255,180,0],[0,0,0],[0,0,0]]}]}

A plan for the night

TimeWhat happensSet with
SunsetNew Year show playlist, or the gold patternSunset timer
EveningCountdown Mode on, bar or text visibleTime & Macros
00:00:00Midnight presetCountdown-Over Preset
00:30Back to the playlistTimer, January 1
01:30OffTimer, January 1

New Year’s Day: set Countdown-Over Preset back to 0, untick Countdown Mode and set the clock overlay back the way you had it.

FAQ

Does WLED have a countdown timer? Yes. Time & Macros has a Countdown Goal (date and time), a Countdown-Over Preset that runs when the goal passes, and Countdown Mode, which shows the time left as a bar on the strip or as text with the Scrolling Text effect.

Why didn’t my preset run at midnight? Most often the time zone. Check “Current local time is” on the Time & Macros page, and that the year is 27 (two digits).

Why did the fireworks come back on January 2? After the goal has passed, WLED runs the Countdown-Over preset again after a restart and when it refreshes its time. Set the preset back to 0 once the night is over.

Can I count down to something else? Any date and time up to 2099: a birthday, the first night of Hanukkah, kickoff. Change the goal and the preset.

Does it work with several lights? Set the goal and preset on each light, or let one light trigger the others through UDP sync.