WLED Christmas Winter Icicle Effects 2D Matrix WLED Max How-To

WLED Icicle Lights and Snowfall Effects: Dripping Icicles, Falling Snow and Icy Twinkles

Make WLED look like icicles and falling snow: effects for a roofline strip, meteor style tubes, and hanging drops of mixed lengths with a 2D gap file.

By

Quick answer: for icicles that drip, use the Drip effect (ID 96) in white or ice blue on a dark background, on LEDs that hang down. Drip forms a drop at the end of the strip and lets it fall toward LED 0, so tick Reverse if your first LED is at the top. For a plain strip along the gutter, an icy twinkle reads as frost from the street: Twinklefox (80) with the Icefire palette and Cool ticked. For hanging drops of different lengths, set WLED up as a 2D matrix with a gap file and every drop drips on its own.

Icicles stay up longer than the rest of the Christmas lights. A white and blue look still fits in January, after the red and green comes down.

Which kind of icicle lights you have

The right setup depends on how the LEDs hang.

What you haveWhat it looks likeSetup
A strip or pixel string along the eaveOne horizontal lineOne segment, icy effects (below)
A few vertical runs (meteor tubes, window sides)2 to 30 separate hanging linesOne segment per run
An icicle string with many drops of different lengthsA fringe of drops2D matrix with a gap file

Check the type first: WLED needs addressable LEDs (WS2811, WS2812B, SK6812 and the like). Store-bought icicle lights with a plug-in controller usually aren’t addressable and can’t be driven by WLED at all.

Icy colors that work on LEDs

ColorHexWLED RGBUse
Ice whiteDCF0FF220, 240, 255Drops and sparkles
Ice blue50B4FF80, 180, 255Drops, the brighter twinkles
Winter blue0050FF0, 80, 255Accents
Night blue (background)000A280, 10, 40Color 2 behind drips and twinkles

Pure white FFFFFF on an RGB strip often looks slightly blue anyway, which helps here. On RGBW strips, use the white LED for the drops and a little blue in RGB: the white channel gives a cleaner ice white than mixed RGB. More on that in colors and the white channel.

A dark background makes drips and sparkles stand out. Keep it very dim: 000A28 looks like a deep night sky, while anything brighter washes out the drops.

Effects for a roofline strip

On a horizontal run, things can’t fall, so go for frost and sparkle instead.

Effect (ID)Colors or paletteSliders and optionsWhat you get
Twinklefox (80)Palette Icefire (36), color 2 night blueSpeed 80, Twinkle rate 160, Cool tickedBlue and white twinkles fading in and out on a faint blue glow
Sparkle Dark (21)Color 1 ice blue, color 2 ice whiteSpeed 220, Intensity 140A blue line with quick white glints, like light on ice
Twinkleup (106)Palette * Color 1, color 1 ice white, color 2 blackSpeed 100, Intensity 128Soft white points slowly appearing and fading
Solid Glitter (103)Color 1 winter blue, color 3 whiteIntensity 80Steady blue with white glitter. The calmest one

Tick Cool on Twinklefox. Without it, Twinklefox makes dimming bulbs turn redder, like old incandescent bulbs. Fine for warm white, wrong for ice.

Twinklefox also shows a dimmed version of color 2 behind the twinkles. That’s why the night blue background works with it; set color 2 to black for twinkles on a dark strip.

Dripping icicles on vertical runs

Each hanging run gets its own segment, so every drop falls independently.

Effect (ID)ColorsSlidersWhat you get
Drip (96)Color 1 ice white, color 2 night blueGravity 60, # of drips 64A drop swells at the top, falls to the tip, bounces once and a new one forms. Slow and real looking
Meteor (76)Color 1 ice white, palette Default (WLED 16 hides the color buttons for Meteor, so pick the color on Solid first)Speed 160, Trail 100A bright head with a fading tail: the meteor tube look
Multi Comet (59)Color 1 ice whiteSpeed 150, Fade 255 (the Fade slider came with 0.15)Several short streaks running down at once, like snow falling past
PS DripDrop (202)Palette Icefire or * Color 1Defaults, try the Rain optionWLED 16 only: drops with a splash at the bottom

Drip’s Gravity slider sets how fast drops fall, and # of drips sets how many fall at a time on one run (one to four). Low gravity looks like melting ice; high gravity looks like rain.

Which way do the drops fall? Drip starts its drops at the last LED of the segment and lets them fall toward the first. Meteor and Multi Comet run the other way, from the first LED to the last.

  • First LED at the top of the run (data comes in from the gutter): tick Reverse for Drip, leave it off for Meteor and Multi Comet.
  • First LED at the bottom: the opposite.

Several runs on one controller

Make one segment per run with the run’s start and stop. When the LEDs zigzag (down the first run, up the second, down the third), every second run is upside down. Tick Reverse on those segments only, and all drops fall the same way. If segments are new to you, segments explained goes through start, stop and reverse.

WLED allows 16 segments on ESP8266 and 32 on ESP32, so one segment per run works up to about that many. For a long fringe of drops, the matrix route below is easier and has no such limit.

A fringe of drops with different lengths (2D matrix)

Real icicle strings have drops of mixed lengths, often a repeating short, medium, long. You can tell WLED exactly that: treat the fringe as a grid that’s as wide as the number of drops and as tall as the longest drop, and mark the grid positions that have no LED. WLED calls that list of positions a gap file.

Example: six drops of 8, 5, 3, 8, 5 and 3 LEDs (32 LEDs), wired down the first drop, up the second, down the third and so on.

  1. Config›LED & Hardware (LED Preferences on 0.14 and 0.15): LED count 32, the real number of LEDs.
  2. Config›2D Configuration: set Strip or panel to 2D Matrix, panel dimensions 6 x 8, one horizontal and one vertical panel, then Populate.
  3. Under Panel 0: 1st LED Top, Left. Orientation Vertical. Serpentine ticked (because the drops go down and up in turn).
  4. Save a text file named 2d-gaps.json with this content, one row of the grid per line, top row first. 1 is an LED, -1 is a place with no LED:
[1,1,1,1,1,1,
 1,1,1,1,1,1,
 1,1,1,1,1,1,
 1,1,-1,1,1,-1,
 1,1,-1,1,1,-1,
 1,-1,-1,1,-1,-1,
 1,-1,-1,1,-1,-1,
 1,-1,-1,1,-1,-1]
  1. Under Gap file, pick the file, click Upload, then Save. If effects look jumbled after that, restart the light once so the map is rebuilt.

With this map, WLED knows that LED 8 is the bottom tip of the second drop and LED 13 the top of the third. The grid has 48 places and 32 of them are LEDs. For your own string, count the drops and their lengths, write one row per LED level, and put -1 wherever a drop has already ended. A value of 0 also exists: that place is an LED that counts in the chain but is never lit, handy for a LED hidden behind the gutter.

Now pick Drip on the whole matrix. Drip is a 1D effect, and WLED’s Expand 1D FX setting for it starts on Bar, which runs the effect separately in every column. Each drop drips on its own and falls downward with no Reverse needed. Every column is as tall as the longest drop, so on the short drops a falling drop runs past the last LED and the bounce isn’t visible. 2D effects work too: Matrix (ID 153) with Custom color ticked, a white spawn color and a pale blue trail color reads as falling snow on a dense fringe.

More on panels, serpentine wiring and testing a layout in the 2D matrix guide.

Snowfall on a window or matrix

On a real LED matrix or a window curtain of LEDs, these look like snow:

  • Matrix (153): tick Custom color (otherwise it stays green), then set Spawn to white and Trail to a pale blue. Lower Spawning rate for light snow.
  • Rain (43): palette * Color 1 with color 1 ice white and color 2 black, low speed, low spawning rate.
  • Drip (96) in Bar mode as above, for melting ice along the top of a window.

Save them and run them all winter

Save each look as a preset, then make a playlist: Twinklefox frost for 10 minutes, Drip for 10, Solid Glitter for 10 (playlists). Point a sunset timer at the playlist with a date range from December 1 to the end of February, and a regular timer at 23:00 turns everything off (timers with date ranges). On WLED 0.14 and 0.15 the sunset slot has no date range, so use a regular timer at about dusk.

Outdoor and power notes

  • Hanging runs are often fed from the top, where water runs down the cable. Use drip loops and outdoor rated connectors.
  • Icicle looks are mostly dark with a few bright points, so they draw much less current than a white roofline. Set Maximum PSU Current anyway, for the moment someone picks full white (numbers and injection).
  • Back up the 2D settings and the gap file once it works. Backup and restore covers cfg.json; keep a copy of 2d-gaps.json next to it.

FAQ

Does WLED have an icicle effect? Not by that name. Drip is the closest: drops swell at the top, fall to the tip and bounce. Meteor gives the meteor tube look, and Twinklefox with the Icefire palette gives frost on a horizontal strip.

Why do my drops fall up? Drip starts at the last LED. If your first LED is at the top, tick Reverse on that segment. In 2D Bar mode the drops always fall down.

Is there a snowfall effect in WLED? On a matrix, Matrix with Custom color ticked, in white and pale blue, is the closest. On vertical runs, Multi Comet with Fade at maximum looks like snow streaking past.

Can I mix icicle drops of different lengths? Yes, with a 2D matrix and a 2d-gaps.json file that marks where each drop ends.

Who wrote this

Jamie Conde, who builds the WLED Max app at MeowScript. WLED itself is an independent open source project, and we are not part of it. WLED Max, our WLED app for iOS and Android, is free for one light with nothing held back. A one-time purchase covers more lights.