---

Connect with ChuckBuilds

• Show support on Youtube: https://www.youtube.com/@ChuckBuilds
• Stay in touch on Instagram: https://www.instagram.com/ChuckBuilds/
• Want to chat or need support? Reach out on the ChuckBuilds Discord: https://discord.com/invite/uW36dVAtcT
• Feeling Generous? Support the project:
  • Github Sponsorship: https://github.com/sponsors/ChuckBuilds
  • Buy Me a Coffee: https://buymeacoffee.com/chuckbuilds
  • Ko-fi: https://ko-fi.com/chuckbuilds/

---

Weather Display Plugin

Comprehensive weather display plugin for LEDMatrix showing current conditions, hourly forecast, and daily forecast.

Current Weather:

Hourly Forecast:

Daily Forecast:

Features

• Current Weather: Temperature, conditions, humidity, wind speed
• Hourly Forecast: Next 24-48 hours of weather data
• Daily Forecast: 7-day forecast with high/low temperatures
• Weather Icons: Beautiful icons matching current conditions
• UV Index: UV radiation levels for sun safety
• Automatic Updates: Configurable update intervals
• Error Handling: Robust retry logic and error recovery

Requirements

• OpenWeatherMap API key (free tier available)
• Internet connection for API access
• Display size: minimum 64x32 pixels recommended

Configuration

API Key

Get a free 1000 Daily API Calls on their pay as you go plan (requires CC but won't charge) via their One Call API Key from OpenWeatherMap:

1. Sign up for an account
2. Navigate to API Keys section
3. Generate a new API key
4. Add it to your plugin configuration

Configuration Options

• enabled: Enable/disable the plugin
• api_key: Your OpenWeatherMap API key (required)
• location: City, state, and country for weather data
• units: Temperature units (imperial for Fahrenheit, metric for Celsius)
• update_interval: Seconds between API updates (minimum 300, recommended 1800)
• display_modes: Enable/disable specific display modes
• display_duration: Seconds to display each mode

Display Modes

weather

Shows current conditions with temperature, condition text, and humidity.

hourly_forecast

Displays next 4-24 hours of forecasted weather with temperatures.

daily_forecast

Shows 3-7 day forecast with daily high/low temperatures.

Usage

The plugin automatically rotates through enabled display modes based on the display_duration setting.

Troubleshooting

No weather data displayed:

• Check that your API key is valid
• Verify internet connection
• Check logs for API errors
• Ensure location is spelled correctly

Slow updates:

• API has rate limits, respect the minimum update interval
• Free tier allows 1000 calls/day

API Rate Limits

OpenWeatherMap free tier provides:

• 1,000 API calls per day
• 60 calls per minute

With default settings (1800s = 30 min intervals), this plugin uses ~48 calls per day.

License

GPL-3.0 License - see main LEDMatrix repository for details.