snel6424/wled-scheduler

WLED is a popular software that runs on small controllers to power addressable LED light strips. This project is a scheduler for those WLED powered lights that runs entirely on the user's own network, with no cloud service, no phone app, and no subscription involved. Once set up, a user can create schedules that turn lights on or off, or switch them to a saved preset, either at a fixed time of day or relative to sunrise or sunset with an adjustable offset, such as fifteen minutes before sunset. Schedules can repeat on chosen days of the week. Everything runs locally: the software calculates sunrise and sunset times itself and talks directly to the lights over the local network, so nothing about a home's lighting habits is sent anywhere else. The recommended way to install it is with Docker, using a single command to build and start the container, after which the user opens a web page on their own device's IP address to manage everything. Because device discovery relies on a local networking technique that needs special handling, the provided setup runs the container with host networking, which only works on Linux, Mac and Windows Docker users are pointed instead to a separate native installation guide meant for a small Raspberry Pi computer. After installation, the user enters their location and timezone so sunrise and sunset can be calculated, then adds their WLED lights by IP address or hostname before creating a first schedule. The app also keeps a searchable history of every schedule that has run and whether it succeeded, and it can be configured to either fire or skip schedules that were missed while it was offline. The project stores everything in a single lightweight database file, is written in Python, and is released under the MIT license.