Open-source holiday lighting
Any day can be a holiday.
csiGarland is a garland of 32 LEDs, each inside a 3D-printed translucent figurine, run by a small controller with its own screen and three buttons. It plays 154 effects, keeps a weekly schedule, and has a web portal and a desktop utility. It needs no cloud and no account: everything works on the garland, with or without a network.
The pictures here are renders of the 3D models and pictures drawn by the firmware's and utility's own code. Photographs follow with the first garland built.
What it does
A garland that stands alone
154 effects
From candles and snowfall to chases and rainbows, in groups, from 101 algorithms in up to four layers. Favourites go on the EFFECT button, and your own effects upload from a file.
Its own screen and buttons
POWER, EFFECT and SPEED on the box, and a 1.3-inch screen that says what plays, how bright and how fast, and how many LEDs it found.
A schedule
Up to 32 actions a week: turn on, set brightness, speed or an effect, turn off. An optional clock module keeps the time through a power cut.
Portal and utility
A web portal on the garland itself, over HTTPS with its own certificate, and a desktop utility that tunes effects with a preview drawn by the firmware's own engine.
Safe by design
The LED rail is switched off in standby, and every frame is held to 1400 mA on a 2 A supply. No effect or setting goes around it.
Updates you can check
Firmware and effects update over Wi-Fi, signed under your own root, tried for a minute and kept only if they work. Every release builds again to the byte.
The figurines
Eight shapes, four of each
Hollow caps of about 48 mm, printed in translucent PETG, snap onto base mounts that hold each LED and its wires. The light spreads through the whole shape.
The control unit
One box: supply, controller, switch
A Waveshare ESP32-C6 board with its screen, a Hi-Link 5 V 2 A supply, a MOSFET that gates the LED rail, and the three buttons, in a printed enclosure. The screen follows the csiPass design.
Portal and utility
Control it from a browser or the desktop
Open source
Yours to build, check and change
Firmware, utility, 3D models and documents are under the MIT License. A release builds again from its sources to the byte, so the file you install is the file the sources make.