chubin

wttr.in: Get Weather Reports in the Terminal

wttr.in is a weather service that returns forecasts as terminal-friendly text, web pages, images, JSON, and metrics. Use it from a shell, embed it in status bars, or run your own instance.

MaintainedGoApache-2.0TerminalAPISelf Hosted
View on GitHub Compare
Stars
30.6k
Forks
1.3k
Stars, last 30 days
+121
Last commit
29 days ago
Contributors
100+

Our take

Maintaineda few commits in the last 90 days

Health score

51/100

How it is scored
Activity
30
Community
63
Issues
69
Pull requests
43

+121 stars in the last 30 days

  • More contributors than 78% of the projects we track

wttr.in is a practical, unusually accessible weather interface with active maintenance, but its recent work is sparse and concentrated heavily in one contributor.

Good fit if

  • You want weather in a terminal, shell script, or status bar rather than a full-featured graphical app.
  • A simple HTTP endpoint and several machine-readable output formats meet your integration needs.
  • You can use the public service or are prepared to configure the external providers for a self-hosted instance.

Look elsewhere if

  • Your service needs a recent release cadence, since the repository has had no release in over a year.
  • You need contributor ownership to be broadly distributed, as most measured contributions come from one person.
  • Your application requires a provider-independent weather backend or a production support commitment not described by the project.
All health signals
Last commit2026-09-07 (29 days ago)
Commits, last 90 days3
Releases, last 12 months0
Contributors100+ (top contributor: 82% of commits)
Issues closed, last 90 days6 (typically closed in 1 day)
Project age10 years

Checked on 2026-10-07 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

30,802

Forks

1,277

Change since Nov 17, 2026: +6 stars·-1 forks

Overview

wttr.in turns a location query into a weather report that works in a terminal, browser, or script. Its simple HTTP interface makes it useful when you want current conditions and forecasts without opening a dedicated weather app.

The public service is the quickest way to use it; the repository also provides a Go server for running an instance yourself. Location lookup and weather data depend on configured external providers when self-hosting.

Key Features

  • Fetch a report with a curl request, using a city, airport code, landmark, IP address, or current IP-based location.
  • Choose terminal ANSI output, plain text, HTML, PNG, JSON, or Prometheus metrics.
  • Request compact or custom one-line fields for scripts and status bars.
  • Select units and output language through URL options or request headers.
  • Query experimental data-rich terminal output and regional map views.
  • Embed weather in tools such as tmux and WeeChat, or use the service as an HTTP API.
  • Build a self-contained Go server with embedded assets for a self-hosted deployment.

Use Cases

  • Terminal users can check local or destination weather without leaving the shell, especially when a quick text forecast is enough.
  • Developers and system administrators can place a compact forecast in tmux, WeeChat, or another status display using the one-line format.
  • Script authors can consume JSON or Prometheus output for lightweight integrations and monitoring.
  • Operators who need control over deployment can build and run the Go server, provided they configure location resolution and weather data sources.

What you need

Detected in the repository

  • Go 1.25.0 or newer (from go.mod)
  • A Dockerfile, so it can run in a container
  • A test suite and automated checks on GitHub Actions

License in plain words

Apache-2.0permissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the license, the NOTICE file and a note of your changes
  • Share your changes: no
  • Includes an explicit patent grant from the contributors:

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Try the public service:

curl wttr.in/London

For self-hosting, see the installation guide in the README for build steps and provider configuration.

Considerations

The project is marked maintained and has recent commits, but only a few were recorded in the last 90 days, and no release was published in the past year. The measured contributor base is at least 100, yet contribution is concentrated in one person, which is a continuity risk. Recent issue handling is relatively quick by the measured median, though only a small number of issues were closed in the same period.

Self-hosting is not just a binary deployment: the documented setup uses GeoIP data and a geocoding provider, and requires a configured weather source. The README also labels the data-rich and map views experimental; the data-rich mode is terminal-only and English-only. The repository uses Apache-2.0, so review its license terms and notice requirements when redistributing or incorporating it.

Found this useful?

Share it with someone who would like wttr.in.