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.
Demo
Terminal previewOverview
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
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.
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.
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
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 skyshows 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 presspto watch the night pass.--jsonand--onelinesay what is up. Uselinecast 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 Orionopens on one. - Sky:
tchooses 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.--cultureandlinecast culturepick 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:
mturns 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? keyshint points to it. - Sky, maps and radar:
wasdpan the view. Maps moves daylight and directions toSandD; radar moves wind and satellite toWandS.
Discussions