The weather, drawn in your terminal.

A tiny CLI that fetches current conditions for any city and renders them as colorful ASCII art. No API key, no account — just weather Lisbon.

★ View on GitHub Install →

$ weather Lisbon

       \   /
        .-.      Lisbon, Portugal
    ― (   ) ―   24°C   feels like 25°C
       `-'      Humidity 45%   Wind 8 km/h   Clear
       /   \

What it does

Condition-aware scenes

Sun, clouds, rain, snow, fog, storms, and a moon & stars at night — each weather state gets its own ASCII scene.

Colored to match

The shape and color tell you the weather before you've read a word. Auto-disables color when piped or with NO_COLOR.

No API key

Uses the free Open-Meteo API — no account, no token, nothing to configure.

Scriptable

--json for machine-readable output, --units imperial, --no-color, an env-var default, and smart city disambiguation.

Install

# Requires Python 3.10+ — installs a `weather` command
pip install git+https://github.com/ctkrug/ascii-weather.git

Usage

$ weather Lisbon                     # current conditions for a city
$ weather Lisbon --units imperial    # °F and mph
$ weather Lisbon --json              # machine-readable output
$ weather "Springfield, Illinois"    # disambiguate shared city names