Weather Widget

Shows current conditions: temperature, feels-like, humidity, description, and sunrise/sunset times. Refreshes every 10 minutes. Can optionally show a 5-day forecast below the current conditions.

Requirements

A free OpenWeatherMap API key.

Getting an API key

1. Create a free account at openweathermap.org
2. Go to My Profile → API keys
3. Copy the default key or generate a new one

Note: New keys can take up to 10 minutes to activate.

Configuration

Key	Type	Default	Description
apiKey	string	—	OpenWeatherMap API key
location	string	—	City name + ISO country code, e.g. London,GB
showForecast	boolean	false	Show a 5-day forecast below the current conditions

The temperature unit (C / F) is a global preference in Settings → Preferences.

5-day forecast

When showForecast is enabled, the widget makes one extra call to OpenWeatherMap's /data/2.5/forecast endpoint (also free-tier) every 10 minutes. The 3-hourly entries are aggregated into one row per day showing:

• Day of the week (localized)
• Midday weather icon and description
• That day's high and low temperature (respects the global C/F preference)

The compact "Header Weather" widget always shows the current conditions only and is unaffected by this toggle.

Location format

Use City,CountryCode format:

London,GB
New York,US
Tokyo,JP
Sydney,AU

Troubleshooting

Widget shows an error

• Verify the API key is correct and activated
• Check the location format matches City,CountryCode
• Free tier has rate limits — wait a few minutes between config changes

Temperature unit is wrong

• Change it in Settings → Preferences → Temperature Unit, not in the widget config