linecast turns free public data into six live, mouse-friendly terminal apps. It is pure Python, has no dependencies, adapts to your terminal theme, and needs no account or API key for its core experience.

Quick try

Run linecast immediately with uv, without installing it:

uvx linecast weather

Or with nothing but curl — get.sh uses whatever the machine has, down to plain python3:

curl -sL https://raw.githubusercontent.com/ashuttl/linecast/main/get.sh | sh

It opens weather in live mode; name another tool with sh -s sunshine, or pass flags with sh -s -- --metric.

Install

With uv:

uv tool install linecast

Or use Homebrew:

brew tap ashuttl/linecast
brew install linecast

On Arch, there is a community-maintained AUR package:

yay -S linecast

pipx install linecast and pip install linecast work too. linecast requires Python 3.10+ on macOS or Linux.

Take it outside

weather
sunshine
moon
tides
radar
maps

Every command finds your approximate location from your IP address and opens in live mode when run in a terminal. Drag or scroll where it makes sense; each app shows its keyboard controls along the bottom.

Pass a place name or coordinates to go somewhere else:

weather --location "Québec"
radar --location 41.88,-87.63
maps --view terrain --location "Innsbruck"
maps --to "Portland Head Light" --profile bike

Use --print for one static frame. When output is piped, linecast does this automatically. Weather, sunshine, moon, and tides also offer --json and compact --oneline output for status bars.

If a short command name conflicts with something already on your system, everything also lives under the linecast namespace:

linecast weather --metric
linecast radar --theme rainbow
linecast maps --view terrain

A closer look

Weather

The weather dashboard combines current conditions, daylight-shaded hourly temperatures, precipitation, daily ranges, air quality, and natural-language comparisons. Official alerts are available across 36 countries and open to their full detail in live mode.

Sunshine and Moon

sunshine is inspired by the Apple Watch Solar face. The arc and sky move through dawn, day, dusk, and night; day length includes its change from yesterday.

moon draws the current phase with its real terminator, mare shading, halo, and orientation for your hemisphere, then tells you what the Moon is doing next. Try moon --oneline for a status bar.

Tides

The tide chart scrolls across several days and annotates exact highs, lows, and the current predicted water level. Coverage comes from NOAA in the US, the Canadian Hydrographic Service, and Queensland Open Data; anywhere else, the chart falls back to Open-Meteo's global tide model, so nearly any coastline works out of the box. An optional TideCheck key adds more named stations. Run tides --nearby to list the closest stations, or tides --station <id or name> to pin one.

Radar

Radar animates recent observations and an hour of forecast over a braille basemap. Real radar is only available where a public radar network publishes an open composite: the United States and Canada, Europe, Japan, Taiwan, Malaysia, and the Philippines. Elsewhere — Australia, New Zealand, South America, most of Asia and Africa — LibreWXR fills in with a precipitation model instead. Model data looks smoother and blockier than radar, and the footer says so when that is what you are seeing. On top of the frames, linecast draws US warning polygons that follow the timeline, optional temperature and wind layers, and hourly infrared satellite imagery.

The default theme uses colors from your terminal's color scheme to draw rain radar data on the map. If your theme is monochrome, the radar data will be too. In addition to the default theme, there are a handful of other local themes — dusk, ember, ink, and marangai — and you can also choose from LibreWXR's server-rendered themes. Press t to switch.

radar --theme dusk
radar --layers temp,wind
radar --layer satellite

Maps

Street view renders OpenFreeMap vector tiles as solid water, land, parks, and buildings under a braille road network. Hover a feature to name and highlight it; search with /, ask for directions with d, or switch views with v. Directions open as a small panel: labelled from, to, and mode fields — each showing the key that edits it, and all clickable — above the turn-by-turn steps. Arrow (or click) through the maneuvers and the map flies along the route.

Terrain view turns global elevation into hillshade and a hypsometric ramp, from deep ocean trenches through lowland green to alpine white. Coastlines, borders, water, and cities are drawn over it in braille.

Zoom all the way out and either view becomes an orthographic globe you can rotate by dragging — or set spinning with r. Two keys switch on the sky as it is right now: s shades the planet into actual daylight, with a creeping terminator and cities glowing on the night side, and c lays the current global cloud cover over it from live satellite imagery. maps --view now opens straight to the full picture.

Everything is a single key — ? shows this list in the app:

maps --location "Portland, Maine" --zoom 0.01
maps --view terrain --location 60.4,5.3 --zoom 8
maps --view now
maps --from "Gorham, Maine" --to "Portland Head Light" --profile foot

Make it yours

Location

Save one location for every command:

linecast location set "Portland, Maine"
linecast location set 44.54,-68.42
linecast location
linecast location auto
linecast location search fayette

The setting lives in ~/.config/linecast/config.json. A command's --location flag or WEATHER_LOCATION takes precedence. Times follow the location: point sunshine or moon somewhere across an ocean and sunrise, sunset, moonrise, and moonset come back in that place's local clock.

Units

Imperial is the default; save metric (or pin imperial) for every command:

linecast units metric
linecast units imperial
linecast units
linecast units auto

This also lives in config.json. A command's --metric, --celsius, or --fahrenheit flag, or the WEATHER_UNITS / TIDES_UNITS variables, take precedence.

Language

Use --lang or LINECAST_LANG to localize the interface. Seventeen languages are supported:

English, French, Spanish, German, Italian, Portuguese, Dutch, Polish, Norwegian, Swedish, Icelandic, Danish, Finnish, Japanese, Korean, Chinese, and Indonesian

weather --lang fr
radar --lang zh

Colour and icons

linecast queries the terminal palette so its colours belong in your theme. Set LINECAST_COLOR to truecolor, 256, 16, or none to override colour detection, or use the standard NO_COLOR variable. A Nerd Font gives the best icon rendering; --emoji or LINECAST_ICONS=emoji uses standard emoji instead.

Shell completion

# Bash
source <(linecast completion bash)

# Zsh
source <(linecast completion zsh)

# Fish
linecast completion fish | source

# Nushell
linecast completion nu | save -f ~/.config/nushell/completions/linecast_completions.nu
# in config.nu:
use ~/.config/nushell/completions/linecast_completions.nu *

Completion covers both linecast <command> and the standalone commands.

Lineage

Prior art.

A Telic-Alcatel videotex terminal draws the weather, sometime in the 1980s. Photograph from the collection at minitel-alcatel.fr.

License

MIT