Back to Catalog
ashuttl GitHub avatar
@ashuttl/linecastVerified Maintainer

linecast

Terminal UI application for weather, tides, sun, moon, and maps

Demo

Terminal preview
linecast
linecast project visual

Overview

Terminal UI application for weather, tides, sun, moon, and maps

Weather, tides, the sun, the moon, and maps, in your terminal. The Old Farmer's Almanac meets Minitel.

From the maintainer

Origin story

I wanted to keep track of the outside world in the terminal without reducing it to a few numbers or a novelty ASCII animation. I kept wanting the things I actually care about, like the weather, the amount of sunlight, and the tides, to be in a coherent, terminal-native visual language. Linecast grew from weather into a little almanac for the terminal.

First workflow

Run `uvx linecast weather`. It needs no setup or API key: it finds your approximate location, opens a live local weather dashboard, and adapts as you resize the terminal. From there, try `radar` or `maps --view now` to see how far the same terminal-native approach goes.

Design choice

It treats the terminal as a graphics medium rather than a constraint. Linecast draws curves, maps, terrain, weather imagery, the lunar terminator, daylight and other continuous data with Unicode braille and ANSI color. It reads your terminal's own palette so it belongs in your machine's theme. And it combines keybaord and mouse interaction without using a TUI framework. The whole thing is pure Python with no dependencies.

Roadmap

Mostly depth rather than breadth now: improving coverage and data sources around the world, polishing the six existing tools, and finding more ways for them to feel native to different terminals and desktop environments.

Latest Release

v2.4.0
Released: Sep 10, 2026

A new view, linecast sky, draws the night sky from where you stand and knows the constellations of twenty-two traditions. Every live view now has a ? help panel, and w a s d pan.

New this version:

  • Sky: linecast sky shows the sky above you: the stars, the constellation figures and their names, the planets, the Moon at its phase, the Sun, and the Milky Way once the sky is dark. Drag to look around, zoom with + and -, scroll through time, and press p to watch the night pass. --json and --oneline say what is up. Use linecast sky --location "auckland" to see the sky from another location.
  • Sky: / searches by name for a star, a planet, a constellation, or an asterism such as the Big Dipper or Orion's Belt, and the view flies to it. If it is below the horizon, the panel says when and where it rises, and Enter again moves the clock to that moment. --at Orion opens on one.
  • Sky: t chooses among the constellations and star names of twenty-two traditions, from the Chinese lunar mansions to the Hawaiian star lines and H. A. Rey's figures. --culture and linecast culture pick one to open on, and Chinese comes with the language. CULTURES.md lists the sources.
  • Sky: With the Hawaiian culture, the horizon carries the navigators' star compass, thirty-two houses from Hikina round to Komohana, and directions are given by house.
  • Sky: Zooming in reveals fainter stars, from a catalog of nearly 117,000, and the galaxies, nebulae and clusters of the Messier list as faint glows. The pointer names them, and / finds them.
  • Sky: m turns toward the Moon when it is up. The Sun and the Moon are cut by the skyline as they rise and set.
  • Every live view has a ? help panel that lists its controls in the display language, and a ? keys hint points to it.
  • Sky, maps and radar: w a s d pan the view. Maps moves daylight and directions to S and D; radar moves wind and satellite to W and S.

Discussions

0 comments
Loading comments...
Alvin By Alvin