# wttr.in
> The right way to check the weather from the terminal via curl

## Summary
Console-oriented weather service accessible via curl that displays rich weather forecasts with ANSI graphics in the terminal.

## Capabilities
- Display current weather conditions and 3-day forecasts
- Query by city name, airport code, IP address, domain, or GPS coordinates
- Support for location names in any language (Unicode)
- Multiple output formats: ANSI terminal, HTML, PNG, JSON, Prometheus metrics
- Show moon phase information
- Narrow single-day or current-condition views with URL parameters
- Metric and USCS unit support
- Experimental regional weather map view (v3)

## When to Use
- When you want a quick weather check from the terminal
- When you need weather data in scripts or pipelines via JSON output
- When you want a visually rich weather display without installing anything

## When NOT to Use
- When you need historical weather data
- When you need highly granular or scientific meteorological data
- When you have no internet connection

## Usage Patterns
### Check weather for a city
```
curl wttr.in/London
```
Displays a 3-day weather forecast for London

### Get weather in JSON format
```
curl wttr.in/Paris?format=j1
```
Returns weather data for Paris as JSON for scripting

### One-line weather summary
```
curl 'wttr.in/Berlin?format=%C+%t'
```
Shows just the weather condition and temperature

### Check moon phase
```
curl wttr.in/moon
```
Displays the current moon phase

## Installation
- **curl**: `curl wttr.in`
- **note**: `No installation needed — just use curl. Self-hosting requires cloning the repo.`

## Related Tools
- [weather-cli](/tools/weather-cli) (alternative): weather-cli is a standalone CLI tool for checking weather
- [aniweather](/tools/aniweather) (alternative): aniweather is another terminal weather tool

---
Source: https://littlescripts.sh/tools/wttr-in