linecast

Seven live terminal apps built on free public data. Pure Python, no dependencies, no accounts or API keys. Colors come from your terminal theme, and the mouse works. Runs on macOS, Linux, and Windows, over SSH, and in tmux.

Install · Using it · The apps · Settings · Contributing

brew install linecast        # Homebrew
uv tool install linecast     # uv
uvx linecast weather         # try it without installing
curl -sL https://raw.githubusercontent.com/ashuttl/linecast/main/get.sh | sh   # with nothing but curl

pipx and pip work too, and there are community packages in the AUR and nixpkgs. linecast needs Python 3.10 or newer. On Windows, use Windows Terminal.

If you can't use a package manager, or would rather carry linecast around as a file, each release also has all of it in one file, linecast.pyz. A package manager is the better choice where you have one, because it keeps linecast up to date for you; the file only tells you, once a week, when there's a newer release. Make it executable with chmod +x linecast.pyz and run ./linecast.pyz weather, or rename it linecast and put it on your PATH. It needs Python 3.10 or newer.

Every command opens live. Press ? for the keys. Add --print for one static frame, --json for raw data, or --oneline for a status bar.

linecast weather --location "quebec"
linecast sky --culture hawaiian
linecast sunshine --year
linecast maps --from "portland, maine" --to "portland head light" --profile bike
linecast maps --view now

The gallery shows each one in more of its states.

An hourly chart on the scale of a typical year where you are, so a mild day looks mild, with a forecast in words. Click an alert to read it. Press v for the year so far, après Tufte: each day's high and low against the last ten years, and each month's precipitation against its average. Press c to change the chart's colors. The first highlights where the temperature went above or below the average, the second uses the temperature colors from the main weather view, and the third is plain.

Reykjavík in Icelandic, and Kyoto in Japanese:

The year view for Westbrook, Maine, with the pointer on a week in May:

The sun on its arc through dawn, day, and dusk. Press v for the whole year. --hours reads the day in traditional hours: halachic, Roman, Edo, Islamic, or Swahili.

Dawn and dusk on the June solstice:

The year in Reykjavík, in Icelandic:

Polar night and midnight sun, at 78° north and 78° south:

The phase as you see it, with the real stars behind. Drag to see the far side; press v for the month. --calendar adds a traditional calendar and its festivals.

Okinawa after the mid-autumn full moon, in Japanese, and the month around it:

The sky over you, now or at any hour. Drag to look around, / to find a star or planet, t to choose among 22 sky cultures.

The whole August sky, and a January evening drawn the Hawaiian way:

National tide services in the US, Canada, Queensland, and Hong Kong, and a global model elsewhere. --nearby lists stations.

The last hour and the next, with US warnings on top. S switches to satellite, t changes the colors.

Streets or terrain; press v to switch, / to search, D for directions. Zoom out to the globe, and press S for daylight and c for clouds.

The labels change with the zoom:

The globe in daylight, and with the hour's clouds:

Run a setting alone to see it, with a value to save it, or with auto to reset it.

Without a saved location, linecast guesses from your IP address, which can be far off on a VPN or over SSH.

Persian support is experimental. It works in Ghostty, Alacritty, and foot, but not well in the Mac's Terminal or iTerm2. See docs/languages.md.

Environment variables are in docs/configuration.md, and data sources and credits in docs/sources.md.

linecast link                       # add weather, moon, … as short commands
source <(linecast completion zsh)   # shell completion: bash, zsh, fish, nu
linecast doctor                     # when something looks wrong

Questions and ideas are welcome in Discussions, and pull requests too; see CONTRIBUTING.md.

Prior art.

A Telic-Alcatel videotex terminal draws the weather, circa 1990. Photograph from the collection at minitel-alcatel.fr.

MIT