astroterm
A terminal-based star map that displays real-time celestial positions of stars, planets, and constellations using ASCII rendering.
What is astroterm?
Astroterm is a terminal-based star map application written in C that displays real-time positions of stars, planets, constellations, and moon phases using ASCII rendering. It solves the problem of accessing accurate celestial data without a telescope or graphical interface by providing a customizable, command-line tool for exploring the night sky.
Astronomy enthusiasts, educators, and developers who want to explore celestial data interactively from the terminal or integrate sky visualization into command-line workflows.
Developers choose Astroterm for its accuracy, lightweight performance, and high customizability—allowing precise sky views for any location and time without external dependencies or complex installations.
Overview
A planetarium for your terminal! Explore stars, planets, constellations, and more, all rendered right in the command line—no telescope required. ✨🪐
Use Cases
Best For
- Exploring real-time celestial positions from the command line
- Educational demonstrations of astronomy concepts in terminal environments
- Viewing past or future sky configurations for specific dates and locations
- Studying constellation shapes and planetary movements with ASCII visuals
- Integrating sky maps into terminal-based applications or scripts
- Learning about moon phases and star magnitudes interactively
Not Ideal For
- Projects requiring high-resolution graphical star maps or 3D visualizations
- Real-time telescope control or integration with astronomical hardware
- Web or mobile applications needing embedded sky maps via APIs
- Users who prefer graphical user interfaces over command-line interactions
Pros & Cons
Pros
Allows precise configuration of date, time, and location for exploring past, present, or future celestial events, with options like city lookup and animation speed multipliers.
Uses reputable sources such as the Yale Bright Star Catalog and NASA JPL data to render stars, planets, and moon phases with scientific precision.
Written in C and optimized for ASCII rendering, ensuring fast and smooth operation in the terminal without heavy resource usage, as highlighted in the performance features.
Available via multiple package managers (Homebrew, Nix, etc.) and prebuilt executables for Linux, macOS, and Windows, making installation straightforward across systems.
Cons
Relies on ASCII characters for rendering, which limits visual detail and may not satisfy users accustomed to graphical planetarium software with high-resolution images.
Unicode display issues can occur on some systems, requiring manual locale configuration as noted in the troubleshooting section, adding setup complexity.
Does not integrate live astronomical data feeds; relies on precomputed catalogs, which may not reflect real-time celestial events or updates beyond the included datasets.
Frequently Asked Questions
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.