Available plugins
The first-party plugins live in the led-ticker-plugins monorepo — one package per plugin. To use one, add its install line to config/requirements-plugins.txt and run docker compose restart — a PyPI name like led-ticker-pool for the published data plugins, or a git+https line for the homage sprite-trail transitions (not on PyPI). See Plugins for the install flow; each plugin’s own README documents its options, layouts, and setup.
Widgets
Section titled “Widgets”Pool water-temperature widget (type = "pool.monitor"), backed by an InfluxDB v2 server. Cycles a title card, today’s temperature, 7-day mean, and season hi/lo with zone coloring; supports ticker and two_row layouts. Full docs, options, and screenshots in the repo README.
- Widgets: pool.monitor
Add to your config/requirements-plugins.txt:
led-ticker-poolFive MLB widgets, backed by MLB’s free StatsAPI (no key required): scores (type = "baseball.scores"), standings (type = "baseball.standings"), home-game promotions/theme nights (type = "baseball.promotions"), Statcast superlatives — longest homer, hardest-hit ball, fastest pitch (type = "baseball.statcast"), and ballpark attendance with fill % (type = "baseball.attendance"). Also ships the baseball.roll / baseball.roll_reverse / baseball.roll_alternating rolling-ball sprite transition and the :baseball.ball: emoji. Full docs, options, and screenshots in the repo README.
- Widgets: baseball.scores, baseball.standings, baseball.promotions, baseball.statcast, baseball.attendance
- Transitions: baseball.roll, baseball.roll_reverse, baseball.roll_alternating
- Emoji: :baseball.ball:
Add to your config/requirements-plugins.txt:
led-ticker-baseballMulti-coin CoinGecko price ticker (type = "crypto.coingecko"). Cycles one ticker card per coin, pulling live spot prices from the CoinGecko API. Three coin-spec styles: a single symbol + symbol_id pair, a symbol_ids = [...] list, or a symbols = [...] list that auto-resolves to unique CoinGecko IDs (raises an error if a symbol is ambiguous — set symbol_id/symbol_ids to disambiguate). Prices below $0.01 format with adaptive sub-cent precision. Keyless free tier is rate-limited to ~5 requests/min; add api_key = "..." (or set COINGECKO_API_KEY) to use a CoinGecko demo key for a higher limit. See the crypto.coingecko widget page for an overview, or the repo README for the full options reference.
- Widgets: crypto.coingecko
Add to your config/requirements-plugins.txt:
led-ticker-cryptoCalendar (.ics) widget (type = "calendar.events"). Pulls upcoming events from any subscribed iCal feed (Google / iCloud / Outlook) and shows them as a rotating agenda, a live next-event countdown, or a held-top two_row card, with keyword filter/highlight and two-tone day/time coloring. Full docs, options, and screenshots in the repo README.
- Widgets: calendar.events
Add to your config/requirements-plugins.txt:
led-ticker-calendarRSS/Atom headline widget (type = "rss.feed"). Fetches a remote feed and turns each headline into its own scrolling line in the section. Polls in the background with retry/backoff. Full docs, options, and screenshots in the repo README.
- Widgets: rss.feed
Add to your config/requirements-plugins.txt:
led-ticker-rssCurrent-conditions widget (type = "weather.current") that shows temperature and a pixel-art condition icon from WeatherAPI.com (needs a free WEATHERAPI_KEY). Polls in the background with retry/backoff. Full docs, options, and screenshots in the repo README.
- Widgets: weather.current
Add to your config/requirements-plugins.txt:
led-ticker-weatherTransitions
Section titled “Transitions”Homage sprite-trail transitions (flair pack)
Section titled “Homage sprite-trail transitions (flair pack)”Four pixel-art character families ship together in the led-ticker-flair package — one install brings all four. Each family provides .forward, .reverse, and .alternating variants; reference them by their namespaced slug, e.g. transition = "pokeball.forward". See Sprite transitions for the full catalogue, screenshots, and per-family details.
led-ticker-flair- nyancat — Nyan Cat with rainbow trail (
nyancat.forward/.reverse/.alternating); hi-res on scaled signs. - pokeball — Pokéball with run-cycle sprite (
pokeball.forward/.reverse/.alternating); hi-res on scaled signs; ships:pokeball.ball:emoji. - pacman — Pac-Man chasing three scared ghosts (
pacman.forward/.reverse/.alternating). - sailor_moon — Moon Stick wand with sparkle trail (
sailor_moon.forward/.reverse/.alternating).
- Transitions: nyancat.forward, nyancat.reverse, nyancat.alternating
Add to your config/requirements-plugins.txt:
led-ticker-flair- Transitions: pokeball.forward, pokeball.reverse, pokeball.alternating
- Emoji: :pokeball.ball:
Add to your config/requirements-plugins.txt:
led-ticker-flair- Transitions: pacman.forward, pacman.reverse, pacman.alternating
Add to your config/requirements-plugins.txt:
led-ticker-flair- Transitions: sailor_moon.forward, sailor_moon.reverse, sailor_moon.alternating
Add to your config/requirements-plugins.txt:
led-ticker-flairThe flair pack also ships two text effects — an animation and a transition — that pair together for a full spin-in / spin-out cycle. Both come with the same led-ticker-flair install. See Animations and Sprite transitions for full documentation, demo GIFs, and per-knob details.
- flair.propeller (
animation, flair >= 0.2.0) —messagewidget text spins in-plane on entry, settling flat before hold time begins. - flair.spinout (
transition, flair >= 0.3.0, core >= 4.6) — the outgoing widget’s content accelerates and spins out, then cuts to incoming. - flair.fisheye (
animation, flair >= 0.4.0, core >= 4.7) — amessagewidget’s scrolling text passes through a stationary squeeze-and-bulge lens; the scroll provides the motion.
- Transitions: flair.spinout
- Animations: flair.propeller, flair.fisheye
Add to your config/requirements-plugins.txt:
led-ticker-flairBackends
Section titled “Backends”A backend is led-ticker’s rendering target — where the sign is drawn (the LED panel, or an alternative like a terminal). Unlike a widget, a backend isn’t added to a section; it’s selected in your display configuration.
Watch your sign in a terminal over Telnet (ANSI rendering).
- Backends: telnet
Add to your config/requirements-plugins.txt:
led-ticker-telnetAdd your plugin
Section titled “Add your plugin”Built one? It belongs here. Open a PR that adds an entry above with:
- a one-line description and the link to your repo,
- a repo
READMEwith install steps and a minimalconfig.tomlwidget block (showingtype =, the required keys, and their defaults) so users can copy-paste — see pool for the shape.
Every working plugin belongs here — including personal-use ones. Listing it grows what led-ticker can do and helps the next person. The authoring guide takes you from nothing to a shippable widget.