Skip to content
led-ticker

weather.current widget

The weather.current widget is provided by the weather package in the led-ticker-plugins monorepo, referenced in config as type = "weather.current". It shows current conditions and temperature from WeatherAPI.com with a pixel-art condition icon.

Weather showing condition icon, label, and temperature in their real deployed colors.
Weather showing condition icon, label, and temperature in their real deployed colors.

Install the plugin and set your API key, then add a widget block to your config:

[[playlist.section]]
mode = "slideshow"
[[playlist.section.widget]]
type = "weather.current"
text = "NYC"
location = "New York"
units = "imperial"

To install the plugin on a Docker deploy, add its line to the plugin manifest and restart:

Terminal window
# First plugin? Create your manifest from the example:
cp -n config/requirements-plugins.example.txt config/requirements-plugins.txt
# Add the package (one name per line), then restart:
echo "led-ticker-weather" >> config/requirements-plugins.txt
docker compose restart

You also need WEATHERAPI_KEY in your .env — free key at weatherapi.com. Other install paths (web UI Store tab, dev checkout) are on the Plugins page.

Full documentation — all options, config examples, and a demo gif — lives in the weather package README.