explaingit

chubin/wttr.in

📈 Trending★ 29,629PythonAudience · developerComplexity · 2/5ActiveLicenseSetup · easy

TLDR

A terminal-based weather service that shows forecasts instantly via command line, no browser needed. Query by city name, airport code, or landmark.

Mindmap

mindmap
  root((wttr.in))
    What it does
      Terminal weather lookup
      Auto IP detection
      Multiple output formats
    Input options
      City names
      Airport codes
      Landmarks
      Auto-location
    Output formats
      Colored text art
      JSON API
      HTML pages
      PNG images
      Prometheus metrics
    Use cases
      Quick terminal checks
      Status bar integration
      Automated scripts
      Weather data APIs
    Tech stack
      Python backend
      Public web service
      IP geolocation

Things people build with this

USE CASE 1

Check weather from your terminal without opening a browser while working.

USE CASE 2

Embed live weather data in shell scripts, status bars, or monitoring dashboards.

USE CASE 3

Query weather API in JSON format to build custom weather applications or integrations.

USE CASE 4

Display weather forecasts in multiple languages and units (metric/imperial) for international users.

Tech stack

PythoncurlJSONHTMLPNGPrometheus

Getting it running

Difficulty · easy Time to first run · 5min
Use freely for any purpose including commercial. Keep the notice and disclose changes to the patent grant.

In plain English

wttr.in is a weather forecast service designed to be used directly from a terminal (the command-line interface on your computer) by typing a simple command like "curl wttr.in/London", no app or browser needed. It solves the problem of quickly checking weather without switching context away from your work environment. The service figures out your location automatically from your IP address if you don't specify one, or you can pass a city name, airport code (three-letter IATA code), or even a landmark like "Eiffel Tower" to get weather for that spot. It responds in several formats: colorful text art for terminals, plain text for scripts, HTML for browsers, PNG images, JSON data for developers, or Prometheus metrics for monitoring tools. You would use it when you're already working in a terminal and want instant weather without opening a browser. It's also useful for embedding weather data in status bars, scripts, or automated tools. Developers can query it as an API to pull weather data in JSON or custom-formatted strings with fields like temperature, humidity, wind speed, moon phase, and UV index. The server handles tens of millions of queries daily and supports multiple languages and both metric and imperial units. It's written in Python and has been running as a live public service since its inception.

Copy-paste prompts

Prompt 1
Show me how to query wttr.in from the command line for a specific city and parse the JSON response in a bash script.
Prompt 2
How do I use wttr.in to display weather in my terminal status bar or system tray?
Prompt 3
Create a Python script that fetches weather data from wttr.in for multiple cities and formats it as a table.
Prompt 4
How can I embed a wttr.in weather widget or image in my website or documentation?
Prompt 5
Show me how to use wttr.in's Prometheus metrics endpoint to monitor weather data in my infrastructure.
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.