wttr.in logo

wttr.in

Console-oriented weather service queried with curl, httpie, or wget. Returns ANSI, plain text, HTML, PNG, JSON, or Prometheus output.

wttr.in is a weather forecast service built for console HTTP clients. You query it with curl, httpie, or wget (or Invoke-RestMethod in PowerShell), and it returns a forecast rendered as ANSI sequences for terminals. Browsers get HTML, and graphical viewers get PNG. The format is chosen from the User-Agent string. JSON, plain text (?T), and Prometheus metrics are also available for scripts and APIs. It began as a wrapper around wego.

Locations go in the URL path: city names (curl wttr.in/London), 3-letter airport codes (/muc), landmarks or mountains (/Eiffel+Tower, /Kilimanjaro), IP addresses, or domain names prefixed with @ (/@github.com). If you give no location, it uses your IP address to guess one. Units are set with ?u (USCS), ?m (metric), or ?M (metric with wind in m/s). Options can be combined, as in ?m2&lang=nl. PNG output is requested by appending .png. It supports transparency options, so the image can be composited onto photos with ImageMagick.

The format parameter gives one-line output. It has presets 1 to 4 and a custom %-notation with codes for condition, temperature, feels-like, humidity, wind, precipitation, pressure, UV index, moon phase, and sunrise and sunset. Several locations can be queried at once. This suits status bars, and the README documents integrations for tmux (with status-interval), WeeChat, and conky, plus an embeddable web widget through wttr-switcher. The README also lists wttr.is as a drop-in fallback domain served from the same backend. Its audience is developers and sysadmins who want weather in a shell, script, status line, or dashboard.

wttr.in weather report for San Francisco

wttr.in in tmux status bar

wttr.in in WeeChat status bar

Alternatives & related tools

add a badge to your README

Maintain wttr.in? Show that it's featured on trmn. The badge links back to this page.

Featured on trmn
Markdown
[![Featured on trmn](https://www.trmn.sh/badge/wttr-in.svg)](https://www.trmn.sh/tools/wttr-in?utm_source=badge)
HTML
<a href="https://www.trmn.sh/tools/wttr-in?utm_source=badge"><img src="https://www.trmn.sh/badge/wttr-in.svg" alt="Featured on trmn" height="20"></a>