Set up F1 print-status lights on a Klipper printer in 30 minutes

My Voron's LED strip changes colour with the print: blue when idle, orange heating, white printing, green chequered flag when it's done, red for errors.

It's WLED_Voron--F1-Lights, and it now has a setup guide that GitHub checks every week.

What a printer repo can test with no printer

Not Klipper itself. But it can check the bits people actually get wrong:

• all eight LED_* macros exist and every value is in range
• the guide's one-line sed really does change all nine IP addresses (there's no single variable for it, which is the most annoying part of the setup)
• the optional print macros only call macros that exist
• each macro's numbers arrive at a fake WLED as valid JSON with the right colour, brightness and effect
• a strip that's switched off can't hang a print: the script gives up in about 3 seconds

The colour trap

Most WS2812B and COB strips are GRB, so red and green arrive swapped. The defaults are written for that: heating sends 80 255 0 to get orange.

If your WLED colour order is already set to match the strip, heating comes out green and errors come out... also green. The guide says exactly which three lines to swap.

Short version

Flash WLED, install gcode_shell_command, copy the script and wled.cfg, change the nine addresses, [include wled.cfg], restart, and type LED_IDLE in the console.

Full steps, with the Moonraker bit and every error I've hit: docs/SETUP.md.

Based on Gliptopolis/WLED_Klipper, reworked on my Voron 2.

What colours would you use for a failed print, red or something more dramatic? 🤖 Drafted with AI assistance from my own homelab notes, logs and repos, then reviewed and edited before publishing.