gitwtfhub

wtf is wled-scheduler?

snel6424/wled-scheduler — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · generalComplexity · 2/5LicenseSetup · easy

TL;DR

A self hosted, cloud free scheduler that automates WLED lights by fixed time or sunrise and sunset, running entirely on the local network.

Mindmap

mindmap
  root((wled scheduler))
    What it does
      Schedule WLED lights
      Sunrise sunset timing
      Local only
    Tech stack
      Python
      Docker
      SQLite
    Use cases
      Time based schedules
      Sunset triggered presets
      Schedule history
    Audience
      Homelab users
      Smart light owners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Automatically turn WLED lights on or off at a fixed time each day.

REASON 2

Trigger a lighting preset relative to sunrise or sunset with a custom offset.

REASON 3

Track a history of every schedule that fired and whether it succeeded.

REASON 4

Run the whole scheduler locally without any cloud account or app dependency.

What's in the stack?

PythonDockerSQLiteWLED

How it stacks up

snel6424/wled-scheduler0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Docker setup needs host networking for device discovery, which is Linux only, Mac and Windows users need the Raspberry Pi native install instead.

Wtf does this do

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.

Yoink these prompts

Prompt 1
Walk me through installing this scheduler with Docker on my home server.
Prompt 2
Explain why host networking is needed for device discovery to work correctly.
Prompt 3
Help me set up a schedule that dims my lights fifteen minutes before sunset.
Prompt 4
Show me the native Raspberry Pi install path since I cannot use Docker host networking.

Frequently asked questions

wtf is wled-scheduler?

A self hosted, cloud free scheduler that automates WLED lights by fixed time or sunrise and sunset, running entirely on the local network.

What language is wled-scheduler written in?

Mainly Python. The stack also includes Python, Docker, SQLite.

How hard is wled-scheduler to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is wled-scheduler for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.