WXTERMv1.2 AMBER

Weather, drawn in text.

wxterm is a full-screen terminal weather display: a live radar loop and live air traffic over a line-drawn map, conditions, a 48-hour graph, tides, the moon and the forecast, in ASCII, box-drawing and braille. It runs on an old laptop as a kiosk with no desktop, or in any big terminal window.

New in 1.2: live air traffic on the map, contributed by Justin Van Bibber. Still in early testing from 1.1: Raspberry Pi 4 and 5 support.

Radar · San Francisco 1920×1080 · one radar loop wxterm in the amber theme showing San Francisco: radar loop over a coastline map, current conditions, a 48-hour temperature graph, tides and the forecast
Five phosphor themes. Press c to cycle, like on the display:

What's on the screen

Radar
The last two hours of radar, looping over coastlines, borders, highways, towns and airports, with range rings. Zoom from 5 to 100 nautical miles.
Now
Temperature in seven-segment digits, feels-like, wind, humidity, pressure trend, and any alerts.
48 hours
Temperature and dew point as braille line plots over rain-chance bars.
Tide · moon
The tide curve through tomorrow with every high and low, plus the moon phase, rise and set.
5-day
Highs, lows, rain chance and a few words for each day.
Air traffic
One key puts live flights on the map: aircraft as arrows with trails and data tags, runways, and the radar loop still running underneath. Contributed by Justin Van Bibber.
Rotating
A panel that cycles between the forecaster's discussion, typed out like a teletype, the surf, and temperatures from the coast inland.

Small touches

l
Next location. Ten are built in: yours plus nine demo cities from San Francisco to Tokyo.
w a
Radar and air traffic, each on or off. + - change the range, Tab picks a flight, t cycles the data tags.
g
Record exactly one radar loop as a GIF. Every GIF on this page was made that way.
f
Big digits as segments, braille dots or blocks.
s
Shuffle the layout. It also happens every 15 minutes, so nothing burns in.
Any size
Built for 240×62 cells at 1080p. The layout follows the terminal down to about 160×45.

Install

On any Linux or macOS machine with Docker and Python 3.11 or newer:

$ git clone https://github.com/jdoscher/wxterm && cd wxterm
$ python3 scripts/new-location.py home 47.6062 -122.3321 --title "SEATTLE"
$ python3 scripts/gen-compose.py
$ cp .env.example .env      # your contact for the NWS API
$ docker compose up -d --build
$ cd display && python3 -m venv .venv && .venv/bin/pip install -e .
$ .venv/bin/wxterm

new-location.py takes a name and coordinates and looks up the rest: timezone, weather station (NWS in the US, the nearest airport elsewhere), tide and water-temperature stations, surf spot, map lines and town labels. Your home location is gitignored.

Outside the US you get airport observations and the Open-Meteo forecast. Alerts and the forecast discussion are NWS products, so those panels are skipped.

Air traffic

Press a and live flights cross the map, through the radar loop if it's on. Each aircraft is an arrow along its track with a braille trail and a data tag: callsign, type, route, altitude with climb or descent, and ground speed. A traffic list beside the map shows everything in view, nearest first, and Tab picks a flight for its details. w turns the radar off for just the sky, and + - zoom both.

Radar + air traffic · Paris 25 NM · colour wxterm in colour over Paris: rain on the radar map with aircraft arrows and data tags around Charles de Gaulle and Orly, and a traffic list beside the map

The flight tracker is the work of Justin Van Bibber, who ported AsciiFlights onto wxterm's map. Thanks, Justin. Aircraft come from the free adsb.fi feed and are fetched only while air traffic is on. It's off by default; AIR=on in kiosk.conf turns it on at first start.

A kiosk, not a window

wxterm was built for an old ThinkPad that does nothing else. One script turns a Debian or Ubuntu machine into a weather terminal: it boots straight to the display, with no login screen and no desktop, and ignores the lid and sleep.

$ sudo mkdir -p /opt/wxterm && sudo chown "$USER": /opt/wxterm
$ git clone https://github.com/jdoscher/wxterm /opt/wxterm && cd /opt/wxterm
$ cp kiosk/kiosk.conf.example kiosk/kiosk.conf
$ python3 scripts/new-location.py home LAT LON --title "YOUR TOWN"
$ sudo bash kiosk/setup.sh && sudo reboot

Under the hood it's cage running foot fullscreen. The bare Linux console can't show braille, so wxterm skips it. One config file covers every setting, and mode.sh desktop gives you the normal desktop back.

Raspberry Pi? See below.

The data side runs in Docker, one small collector per location, so switching cities is instant. The display itself is Python with Textual.

Raspberry Pi Early testing

Early testing. Pi support is new in 1.1. It passes an emulated ARM64 test: the Docker images build, a collector fetches every source, the display renders, and every package it needs exists for arm64. It hasn't run for any length of time on a real Pi yet. Expect rough edges, and please open an issue with your model, OS and what happened.

You need a Raspberry Pi 4 with 4 GB or more (a Pi 5 should also work), a 1080p screen on HDMI, and ideally a USB SSD to boot from. The collectors write their cache every few minutes around the clock, which wears out SD cards.

  1. In Raspberry Pi Imager, flash Raspberry Pi OS Lite (64-bit). In its settings, set a username, your Wi-Fi if needed, and turn on SSH.
  2. Plug the screen into the HDMI port next to the power socket, boot, and SSH in.
  3. Run the commands on the right, with your own coordinates. The first run downloads map data and builds the Docker images, so it takes a while. After the reboot the Pi goes straight to the weather.
$ sudo apt update && sudo apt full-upgrade -y && sudo apt install -y git
$ sudo mkdir -p /opt/wxterm && sudo chown "$USER": /opt/wxterm
$ git clone https://github.com/jdoscher/wxterm /opt/wxterm && cd /opt/wxterm
$ cp kiosk/kiosk.conf.example kiosk/kiosk.conf
$ sed -i 's/^PROFILE=standard/PROFILE=pi/' kiosk/kiosk.conf
$ python3 scripts/new-location.py home LAT LON --title "YOUR TOWN"
$ sudo bash kiosk/setup.sh && sudo reboot

PROFILE=pi runs four cities (home, San Francisco, London, Tokyo) instead of ten and animates a little slower. Choose your own with LOCATIONS="home nyc paris" in kiosk.conf.

Not known yet: load and temperature over days of running, GIF encode time, and whether a Pi 5 or a 2 GB Pi 4 wants different settings.

Ask your LLM

An optional, read-only MCP server lets Claude or any MCP client read the weather and the kiosk's status, and take a screenshot. It can't change anything. It's off by default, requires a token, and refuses requests from browsers.

$ claude mcp add --transport http wxterm \
    http://KIOSK:8090/mcp --header "Authorization: Bearer TOKEN"
From the kiosk, 16 Nov 2026

Is it raining in San Francisco?

get_radar_summary(location="sf")

Yes: heavy rain over the city right now, drifting west-southwest at about 12 mph.

Is the kiosk running hot?

get_status

No. The CPU is at 42 °C, both batteries are full on AC power, and all ten collectors are up to date.

Free data, no keys

WhatSource
ConditionsNWS stations in the US, aviationweather.gov METARs elsewhere
ForecastNWS, and Open-Meteo for hourly data and places outside the US
RadarRainViewer composite, with IEM NEXRAD as a US fallback
TidesNOAA CO-OPS, or Open-Meteo's sea-level model where there's no gauge
SurfOpen-Meteo marine
Sun · moonComputed locally
Aircraftadsb.fi open data, with adsb.lol as a fallback; routes from adsbdb
MapsNatural Earth (public domain), OurAirports runways and GeoNames town names

Around the world