Skip to content
led-ticker

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.

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-pool

Five 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-baseball

Multi-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-crypto

Calendar (.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-calendar

RSS/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-rss

Current-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-weather

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-flair

The 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) — message widget 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) — a message widget’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-flair

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-telnet

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 README with install steps and a minimal config.toml widget block (showing type =, 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.