WLED Christmas Christmas Tree Holiday Segments Effects WLED Max How-To

WLED Christmas Tree Lights: How Many LEDs, How to Wrap the Tree, Tiers and the Best Effects

Plan a WLED Christmas tree: pixels for a 4, 6 or 7.5 ft tree, spiral or vertical strands, one segment per tier, the star, and effects that suit a tree.

By

Quick answer: use a string of round “bullet” pixels rather than a flat strip, wrap it in a spiral from the bottom up, and make one WLED segment per turn or tier. A 6 ft tree takes about 150 to 300 pixels depending on how tight you wrap. Twinkle effects (Twinklefox, Fairytwinkle, Colortwinkles) look good however the lights hang; moving effects like Running and Rainbow only look right when the lights follow a clear path, like a spiral. Keep the last few LEDs for the star.

A tree is the one Christmas display people look at from a metre away, so it pays to plan the wrap before the lights go on.

Strip or pixel string?

Bullet pixel stringLED strip
Looks likeClassic tree lights, one point per bulbA continuous band of light
SpacingAbout 7 to 10 cm (3 to 4 in) between pixels30, 60 or 144 LEDs per metre
WrappingBends anywhere, tucks into branchesOnly bends flat, fights the branches
Typical voltage5 V or 12 V, 50 pixels per string5 V, 12 V or 24 V

For a real or artificial tree, the string wins. Strips work on flat trees (wall trees, a cone of wire mesh) and for a ring around the base. Both are just “LEDs” to WLED, set up the same way under LED & Hardware.

How many LEDs for your tree

A spiral wrap is the sum of the circles around the tree. Roughly:

length of the wrap ≈ 3.14 × (base width ÷ 2) × number of turns

where the number of turns is the tree height divided by the gap between turns. With a 20 cm (8 in) gap and pixels every 10 cm:

TreeBase widthTurnsWrap lengthPixels
4 ft (1.2 m)0.75 m6about 7 mabout 75 (two strings of 50)
6 ft (1.8 m)1.1 m9about 16 mabout 160 (three or four strings)
7.5 ft (2.3 m)1.4 m11 or 12about 25 mabout 250 (five strings)

Halve the gap or wrap each branch in and out and the counts roughly double. That’s how the lush trees in videos end up at 500 pixels and more. Every one of those numbers is easy for an ESP32. An ESP8266 handles a few hundred fine too, but leaves less room for effects and segments.

Power: work it out in the roofline power calculator, and set Maximum PSU Current to what your supply can give. Indoors a tree looks best at 30 to 50 percent brightness anyway, so a supply sized for that plus the limiter is fine.

Three ways to wrap, and what each can do

Spiral, bottom to top. One string wound round from the trunk end up to the tip. Each turn is a run of consecutive LEDs, so each tier of the tree is simply a segment, and every effect that moves along the strip climbs the tree in a spiral. This is the one to pick if you want motion.

Vertical strands from the top. Strings hang from the top down the sides, like a mega tree. Each strand is a column, so the tree is a grid: in Config›2D Configuration set it up as a 2D matrix with one column per strand (how to set up a matrix). Then 2D effects draw across the whole tree. A cone is narrower at the top than the grid assumes, so pictures get squeezed toward the tip; most effects still look good.

Draped by hand, in and out of the branches. The most natural looking tree, and the most common. WLED doesn’t know where each pixel ended up, so anything that moves along the string looks like random flicker. Stick to twinkles and solid patterns, which look the same whatever the order. (Mapping every pixel in 3D is possible with xLights or camera-mapping scripts, but that’s a project of its own.)

One segment per tier

On a spiral tree, segments turn the tiers into something you can color separately: red and green tiers, a gold top, a different twinkle on the bottom third.

  1. Set the whole strip to Solid in one color.
  2. Create segment 1 from LED 0 and move its Stop until the light ends exactly where the first turn is complete. Note the number.
  3. Repeat for each turn or group of turns. Every segment starts where the last one stopped.
  4. Give the last 5 to 15 LEDs (whatever sits at the tip) their own segment for the star.

The upper turns are shorter, so the segments get smaller toward the top. That’s expected. WLED allows 16 segments on ESP8266 and 32 on ESP32, which is plenty for tiers plus a star. Save the layout as a preset straight away so you can always get back to it. The details of start, stop and grouping are in segments explained.

Two classic tier looks:

  • Alternating tiers: odd segments red, even segments green, all on Solid or all on Breathe at low speed.
  • Ombre: color the tiers from deep green at the bottom to white at the top, with Fairytwinkle on all of them.

The star on top

Keep it simple and steady: its own segment on Solid in gold (FFB400) or warm white (FFB45A), at the end of the strip. Presets that leave that segment alone keep the star lit while the rest of the tree changes. A separate pixel ring or star shape can go on the same data line after the last pixel, as long as its LEDs are the same type and color order as the string.

Effects that look good on a tree

Sliders go from 0 to 255; the numbers are starting points.

Effect (ID)Colors or paletteSlidersWorks onWhat you get
Twinklefox (80)Palette C9 (48), color 2 blackSpeed 128, Twinkle rate 128Any wrapOld style multicolor bulbs twinkling
Fairytwinkle (51)Palette * Color 1, color 1 FFB45A128, 128Any wrapWarm white bulbs that dim and brighten at random
Colortwinkles (74)Palette Jul (31)Fade speed 128, Spawn speed 128Any wrapRed and green fading in and out
Fairy (49)Palette C9 (48)Speed 128, # of flashers 128Any wrapA multicolor string with some bulbs flashing
Running (15)Color 1 red, color 2 whiteSpeed 40, Wave width 128SpiralCandy cane stripes winding up the tree
Rainbow (9)DefaultSpeed 60, Size 16SpiralColors flowing slowly up the spiral
Sinelon (92)Palette Jul (31)Speed 80, Trail 200SpiralOne light running up and down the tree with a long tail
Candle Multi (102)Color 1 FFB45ASpeed 96, Intensity 224Any wrapEvery pixel flickers like a candle

On a tree built as a 2D matrix (vertical strands), open a 1D effect’s segment options and set Expand 1D FX to Bar. The effect then runs up and down every strand at the same height, so Running or Rainbow turns into rings that rise around the whole tree.

For repeating patterns like 2 red, 1 white or retro C9 bulbs with dark gaps, see the Christmas patterns guide. On a draped tree a pattern looks like random colored bulbs, which is exactly what a classic multicolor tree is.

Patterns from your phone

In WLED Max on iOS and Android, Pattern Maker builds those repeating patterns without segment tables: Classic Christmas, Retro Bulbs, Candy Cane, Gold & White and the rest, with a motion like Twinkle or Glow, shown live on the tree while you edit. Open the light on the Control tab and tap Make a Pattern. Choose Whole light or one segment (keep the star out of it), then Save as Preset. Pattern Maker works on strips and strings, not on lights set up as a 2D matrix.

Make it switch itself

  • Smart plug or a timer outlet? Set a power-on preset, so WLED starts with your tree look instead of the default orange (power-on preset).
  • WLED timers: on at 16:00, off at 23:00, with a date range from your tree day to January 6 (timers with date ranges).
  • A playlist: Twinklefox for 10 minutes, the candy cane spiral for 10, warm white for 10 (playlists).

Common problems

  • Colors wrong (red shows as green): set Color order in LED & Hardware (LED Preferences on 0.14 and 0.15). 12 V bullet strings are often RGB rather than the GRB most 5 V strips use. Set it before building any tiers.
  • The first pixel is a different color or flickers: a long, thin data wire from the controller. Keep the data wire short, or add a single “sacrificial” pixel near the controller.
  • Last string dim or yellowish: voltage drop. Feed power at both ends of the run, or between strings (power injection).
  • Moving effects look like random noise: the lights are draped rather than wrapped in order. Use twinkle effects, or rewrap the tree in a spiral.

FAQ

How many LEDs do I need for a 6 foot Christmas tree? About 150 to 300 pixels for a spiral wrap, depending on the gap between turns. Wrapping each branch takes about twice that.

Should I use LED strip or pixels on a Christmas tree? Pixel strings. They bend between the branches and look like classic tree lights. Strips suit flat or mesh trees.

Can I make each tier of the tree a different color? Yes. On a spiral wrap, make one segment per tier and give each segment its own color or effect.

Do I need xLights for a WLED tree? No. WLED handles effects, tiers, presets and timers on its own. xLights is for a tree sequenced to music (when xLights is worth it).