Back to Catalog
Igfray GitHub avatar
@Igfray/starwheelVerified Maintainer

starwheel

I found that there wasn’t a cool planetarium for the terminal . starwheel - see the stars in your terminal

Overview

A live planisphere in your terminal, showing real star positions for your location and time

A live planisphere in your terminal. Real star positions for your location and clock, drawn in braille.

From the maintainer

Maintainer profile

starwheel

I found that there wasn’t a cool planetarium for the terminal . starwheel - see the stars in your terminal

Maintainer Website

A live planisphere in your terminal, showing real star positions for your location and time

Origin story

I found that there wasn’t a cool planetarium for the terminal . starwheel - see the stars in your terminalI’ve always been an astronomy nerd and I wondered if I could find something where I could see real time stars in the terminal, I couldn’t find anything sufficient so I built one myself. Really fun project to do.

First workflow

It’s pretty intuitive, I’d say the the coolest thing to try is following the steps to include a local llm to analyse the star/planet/constellation

Design choice

I’m pretty sure it’s the only tui planetarium made with nodejs. I invite you to try it out, relatively easy to set up.

Roadmap

Starwheel to push daily notifications of what to look for in the sky tonight. I feel like the coolest goal to try and achieve is to be able to implement a digital telescope where the program dynamically changes based on what the telescope is pointed at. I’ve been working on improving the celestial accuracy.

Cross-platformWebsiteWebsite

Installation

npxlinuxmacoswindows
Maintainer Verified Source

https://github.com/Igfray/starwheel#readme

$
npx starwheel

Latest Release

starwheel 0.2.0
Released: Aug 10, 2026

Find objects by name, finer time control, and a fix for constellation labels being drawn at the wrong right ascension.

See the commit for the full story on the bug.

Discussions

0 comments
Loading comments...
Alvin By Alvin