# wttr.in

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

Stars: 30.7k · Language: Go · License: Apache-2.0 · Categories: Network

- Repository: https://github.com/chubin/wttr.in
- Website: https://wttr.in
- Page: https://www.trmn.sh/tools/wttr-in

## Overview

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](https://media.trmn.sh/cached/5b6739b30dff500cfc79e88330579fecccf0bf80e957bac4e8b62a86955929d3.png)

![wttr.in in tmux status bar](https://media.trmn.sh/cached/6a70abfc9cb55bdb2522358e67d05a4ce5eab4652715a92ae376cbb083d21bdb.png)

![wttr.in in WeeChat status bar](https://media.trmn.sh/cached/7915679ee0c32256acc2f43fef121adcf5e42acff5904d62feac6dfd20bd7079.png)

## Alternatives

- [nuclei](https://www.trmn.sh/tools/nuclei.md): YAML template-based vulnerability scanner for web apps, APIs, networks, DNS and cloud, with TCP, HTTP, DNS, SSL, WHOIS and JavaScript protocols. (Go, 32.4k stars)
- [vegeta](https://www.trmn.sh/tools/vegeta.md): HTTP load testing CLI tool that generates constant request rates with comprehensive reporting and UNIX composability (Go, 25.2k stars)
- [hey](https://www.trmn.sh/tools/hey.md): HTTP load testing tool that sends concurrent requests to web applications and reports performance metrics (Go, 20.7k stars)
- [katana](https://www.trmn.sh/tools/katana.md): Go-based web crawler from ProjectDiscovery with standard and headless Chrome modes, JavaScript endpoint parsing, scope control, and JSON output for pipelines. (Go, 17.8k stars)
- [subfinder](https://www.trmn.sh/tools/subfinder.md): Passive subdomain enumeration tool written in Go that queries online sources, with JSON output, wildcard elimination, and STDIN/STDOUT support. (Go, 14.7k stars)

---

Canonical: https://www.trmn.sh/tools/wttr-in