# wttr.in: Get Weather Reports in the Terminal

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/chubin-wttr.in
Generated for open source discovery and AI-assisted research.

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.

GitHub: https://github.com/chubin/wttr.in
OSRepos URL: https://osrepos.com/repo/chubin-wttr.in

## Summary

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.

## Topics

- go
- terminal
- api
- self-hosted
- weather-forecast
- weather-api
- weather-cli

## Repository Information

Last analyzed by OSRepos: Wed Oct 07 2026 02:30:22 GMT+0100 (Western European Summer Time)
Detail views: 22
GitHub clicks: 23

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## 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.

## Our Take

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.

## Project Health

| Signal | Value |
|---|---|
| Status | **Maintained**: a few commits in the last 90 days |
| Last commit | 2026-09-07 (29 days ago) |
| Commits, last 90 days | 3 |
| Releases, last 12 months | 0 |
| Contributors | 100+ (top contributor: 82% of commits) |
| Issues closed, last 90 days | 6 (typically closed in 1 day) |
| Project age | 10 years |

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

## Project Facts

- Language: Go
- License: Apache-2.0
- Stars: 30.6k
- Forks: 1.3k
- Topics: ascii-art, curl, terminal, weather, weather-api, weather-app, weather-information
- Archived: no

## 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

## Getting Started

Try the public service:

```sh
curl wttr.in/London
```

For self-hosting, see the [installation guide in the README](https://github.com/chubin/wttr.in#installation) for build steps and provider configuration.

## License in Plain Words

**Apache-2.0** (permissive).

- 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.

## 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.