led-ticker

A Python toolkit for RGB LED matrix signs — configurable feeds in TOML, extensible with plugins.

A `message` widget with rainbow per-character coloring — one of the built-in widgets.

Two ways in

Run a sign

You have, or want, an RGB LED matrix sign. Describe what it shows in a TOML config — RSS, weather, scores, countdowns, images — no Python required.

Why led-ticker? — is this the right tool for your sign?
Get started — install and light up a sign in minutes
Tutorial — build a complete config step by step
Browse widgets — every built-in building block

Build on it

You want to extend led-ticker. Add widgets, transitions, color providers, fonts, or lifecycle hooks through the public led_ticker.plugin API — without forking core.

Plugins — how extensions install and load
Write a plugin — a guided walkthrough

What you can put on it

Weather (plugin)

Weather widget →

MLB scores (plugin)

Live game scores and counts — via the baseball plugin.

MLB widget →

Crypto prices (plugin)

Multi-coin CoinGecko price ticker, trend-colored.

Animated GIFs

Countdowns

…and your own

Writing a plugin

led_ticker.plugin is the public surface plugins import from — it exposes widget, transition, emoji, font, and lifecycle-hook registration, no fork of core needed. The pool water-temperature widget shown above is a real plugin that lives in the led-ticker-plugins monorepo and contributes type = "pool.monitor".

Plugins overview — install, load, and the [plugins] config block
Write a plugin — scaffold, build, and package one

Where to next

Run a sign: Get started · Tutorial
Pick content: Widgets · Transitions
Extend it: Plugins · Write a plugin
Get the hardware: Building your own

Using an AI coding agent? These docs are available as plain Markdown at /llms.txt (index) and /llms-full.txt (everything in one file).