Skip to main content
otter-weather fetches current conditions and a 7-day forecast from Open-Meteo. It feeds the bar weather widget or opens a popup. Set your latitude and longitude, run it as a watch daemon, and weather shows up on your desktop.

​
Usage

Run otter-weather without arguments to fetch and print a forecast for the configured location. Pass coordinates to override the config.

​
Bar Widget Integration

The otter-bar weather widget reads from a bounded local cache file. Use --write-cache to refresh that cache after a fetch. Add --watch SECONDS to keep it updated in the background. A typical autostart line:
The --layer flag opens the cached forecast in a small layer-shell popup that closes when clicked. Bind it to the bar widget button.
Responses are capped at 128 KiB, so the cache file stays small and fetch time stays predictable.

​
Configuration

otter-weather reads ~/.config/otter-shell/otter-weather.conf.
  • latitude / longitude: your location (default is London)
  • cache_path: cache file location. Empty uses the default XDG cache location
  • write_cache: write cache after fetch
  • watch_seconds: refresh interval in watch mode. Config reloads between refreshes, so you can change location without restarting the daemon
Find your coordinates at Open-Meteo’s geocoding API or use a site like latlong.net.