Weather — butter docs Skip to content
Widgets / The day

Weather

Local conditions and a daily high / low, with optional wind, humidity, precipitation chance, and sunrise / sunset. Quiet by default, opinionated when you ask it to be.

A glanceable weather card: current conditions, today's high and low, and a row of optional metrics underneath if a glance isn't quite enough. Powered by Open-Meteo — no API key, no account, no advertising SDK riding shotgun.

Free 4×2 default, up to 4×3 30-minute cache
Weather
62°
San Francisco · Partly cloudy
H 68° · L 54°
9 km/h 62% 20% 06:42

Add it to your dashboard

Press E to enter edit mode, then A and pick Weather. The widget ships with San Francisco as a placeholder location — open settings on the new widget and search for your actual city before you stop noticing.

A small default chip appears next to the location name when you're still on the San Francisco coordinates. It's a quiet nudge, not a nag — once you set your city it goes away.

Where the data comes from

Weather uses the Open-Meteo API for both geocoding and the forecast itself. Two endpoints, both unauthenticated:

  • Geocoding. When you type a city and hit Search, butter calls geocoding-api.open-meteo.com with your query and stores the first result's coordinates plus a display name. We do not use navigator.geolocation — no system permission prompt, and your physical coordinates never leave the device unless you explicitly search for them.
  • Forecast. The widget then fetches conditions for those coordinates and caches the response for 30 minutes per location + unit combo. Switching units re-uses the cache. Changing location starts a new cache entry.

Settings

Enter edit mode with E , then click the gear in the Weather's title bar or right-click the widget.

Setting Type Default
Location

Type a city and press Search (or Enter) to geocode it through Open-Meteo. The first match wins. Stored as latitude / longitude plus a display name, so renaming the place locally doesn't mess with the lookup.

city search San Francisco, CA, US
Units

Switches the readout, the high / low, and the wind speed. Open-Meteo returns the values pre-converted, so the change is instant — no re-fetch hop.

°C · °F °C
Wind speed

Shows current wind speed in the metrics row, in km/h.

toggle off
Humidity

Shows relative humidity as a percentage.

toggle off
Precipitation chance

Probability of precipitation today, percentage.

toggle off
Sunrise & sunset

Renders sunrise and sunset times for today, formatted in your browser's locale.

toggle off

Small things you might miss

  • The icon tracks day / night. Open-Meteo returns an is_day flag, and the cloud / sun / moon mapping respects it — so an overcast night reads moon behind cloud, not sun behind cloud with the colours inverted.
  • Metrics gracefully no-op. A cached response from before a metric existed will skip that row instead of showing a question mark. The cache refreshes within 30 minutes and the row reappears on its own.
  • Errors show a retry, not a dead card. If the API hiccups or your network is offline, the widget shows the error message with a small refresh icon you can click. No silent failure.

Heads up

  • Geocoding is one-shot. The search picks the top match — if you live in a city called Paris that isn't in France, type a qualifier like Paris, TX to disambiguate.
  • Cache lives on the device. Each device hits Open-Meteo independently. There's no per-account quota to share.
  • No alert / severe-weather feed. The widget is glance conditions, not a warning system — if a tornado is coming, your phone or NOAA will be a better friend than your new tab.