whatisgithub

What is wttr.in?

chubin/wttr.in — explained in plain English

Analysis updated 2026-05-18

29,531PythonAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

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
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

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.

What is it built with?

PythoncurlJSONHTMLPNGPrometheus

How does it compare?

chubin/wttr.insearxng/searxngatsushisakai/pythonrobotics
Stars29,53129,50129,418
LanguagePythonPythonPython
Setup difficultyeasymoderateeasy
Complexity2/54/52/5
Audiencedeveloperops devopsresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get 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.

So what is it?

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.

Frequently asked questions

What is wttr.in?

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

What language is wttr.in written in?

Mainly Python. The stack also includes Python, curl, JSON.

What license does wttr.in use?

Use freely for any purpose including commercial. Keep the notice and disclose changes to the patent grant.

How hard is wttr.in to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is wttr.in for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.