wttr.in

Console weather forecast service

TLDR

Get weather for current location (based on IP)

$ curl wttr.in

Get weather for a specific city

$ curl wttr.in/[Paris]

Get weather for a landmark or named location

$ curl "wttr.in/~[Eiffel Tower]"

Get current weather only (no forecast)

$ curl wttr.in/[London]?0

Get one-line weather summary

$ curl "wttr.in/[Berlin]?format=3"

Get weather in metric units

$ curl wttr.in/[NewYork]?m

Get moon phase

$ curl wttr.in/moon

Get weather as PNG image

$ curl wttr.in/[Tokyo].png --output weather.png

SYNOPSIS

curl wttr.in/[location][?options]

wttr.in is a console-oriented weather forecast service accessed via HTTP clients like curl, wget, or httpie. It provides weather information in ASCII art format directly in the terminal, requiring no installation.The service supports various location types: city names, 3-letter airport codes, GPS coordinates, area codes, domain names (prefixed with @), and landmarks (prefixed with ~). Without a location, it uses your IP address to determine location.Output can be customized for different use cases: full 3-day forecasts, current conditions only, one-line format for status bars (tmux, shell prompts), or PNG images. The v2 endpoint (v2.wttr.in) provides expanded data including historical information.wttr.in supports multiple languages and both metric and imperial units. The service handles millions of queries daily and is free to use.

PARAMETERS

location

City name, airport code (3 letters), GPS coordinates, area code, or domain name.

Show only current weather (no forecast).

Show current weather and today's forecast.

Show current weather, today's and tomorrow's forecast.

Use metric (SI) units.

Use USCS (US) units.

Narrow version showing only day and night.

Quiet version without "Weather report" header.

Superquiet version (no "Weather report" text, no city name).

?format=string

Custom format for one-line output. Presets: 1-4. Custom: %c (condition), %t (temperature), %w (wind), %h (humidity), %l (location), %m (moon phase).

Disable terminal sequences (for piping).

Do not show the "Follow" line.

Restrict output to standard console font glyphs.

Show wind speed in m/s.

?lang=code

Set language (e.g., lang=de for German). Also available as subdomain: fr.wttr.in.

.png

Return weather as PNG image instead of text.

CAVEATS

Requires internet connection and an HTTP client (curl, wget). Location detection via IP may be inaccurate for VPNs or proxies. Rate limiting may apply for excessive requests. ASCII art display requires a terminal with sufficient width and Unicode support for best results.

HISTORY

wttr.in was created by Igor Chubin around 2016 as a wrapper for the wego weather client, demonstrating console-oriented web services. It gained popularity through Hacker News and social media, growing to handle tens of millions of daily queries. The service continues to be maintained and improved with new features.