Skip to content
led-ticker

Widgets

led-ticker ships 6 built-in widget types. Each is configured by a [[playlist.section.widget]] block in your TOML. This page is the menu — pick the one that fits your data, then read its page for the full options list.

WidgetSourceUse when
messagestatic textmost lines on most signs
clocklocal clockcurrent time (12h/24h, optional date/tz)
countdownlocal clock + a target date”X days until …”
two_rowtwo static linesheld-handle + scrolling promo (storefront)
giflocal fileanimated gifs / webp / multi-frame images
imagestatic PNG / JPGlogos / single still graphics
pool (plugin)pool_monitor InfluxDBwater temp (today / 7-day / season)
baseball.scores (plugin)MLB free APIgame scores / series state
baseball.standings (plugin)MLB free APIstandings (top N + tracked teams)
crypto.coingecko (plugin)CoinGeckomulti-coin price ticker
calendar.events (plugin)iCal / .ics URLupcoming events, agenda / next / two_row
rss.feed (plugin)any RSS URLnews / blog headlines
weather.current (plugin)WeatherAPI.comforecast / current conditions
  • Just text: message, countdown, clock. No external dependencies.
  • Two text rows (storefront layout): two_row at section scale=2.
  • Live data (background fetch): all plugin widgets — pool, baseball.scores, baseball.standings, crypto.coingecko, calendar.events, rss.feed, and weather.current. Each has retry + exponential backoff.
  • Visual: gif, image. Both support text overlay, fit modes (pillarbox / letterbox / stretch / crop), and per-row two-row layouts.

Most widgets share these — see the message widget for the canonical surface:

  • font, font_size, font_threshold — see Fonts
  • font_color — see Color providers
  • bg_color — RGB list, painted across the panel before content; see Section backgrounds
  • border — a ring around the panel: rainbow chase, color cycle, constant, color bands, or lightbulb marquee (Borders)
  • animation — typewriter (where supported)