SkyCanvas
ASCII constellation viewer powered by astronomical data.
SkyCanvas is a lightweight command-line tool that allows you to explore constellations directly in your terminal. It renders constellations as ASCII art, displays astronomical data, compares different constellations, show currently visible constellations, and allows exporting them into image formats.
No internet connection is required after installation.
Features
- ASCII constellation rendering
- Braille based terminal render
- Constellation information tables
- Stars and their connections visualised
- Animated constellation drawing
- Comparing two constellations side by side
- Showing visible constellations for tonight
- Random constellations to discover
- Export constellation to PNG / JPG / BMP / SVG format
- Manual
- Lightweight and quite fast
Installation
Requirements
- Python 3.10+
- pip
Install SkyCanvas:
pip install skycanvas
Example:
Run:
skycanvas --help
Commands
version
Show SkyCanvas version.
skycanvas version
man
Display the SkyCanvas manual.
skycanvas man
constellation
Display the constellation ASCII art and info table of choice.
skycanvas constellation <name>
constellation --animate
Display animated version of ASCII art, and info table of choice.
skycanvas constellation <name> --animate
compare
Compare two constellations.
skycanvas compare <name1> <name2>
list
Display the list of available constellations.
skycanvas list
tonight
Display constellations that are visible tonight.
skycanvas tonight
--export
Export the chosen constellation or tonight constellations to an image format.
skycanvas --export crux svg
Available image formats:
- PNG
- JPG
- BMP
- SVG
Exports are stored in:
~/SkyCanvas/Exports/
rand
Show a randomly choosen constellation.
skycanvas rand
export-help
Display export usage information.
skycanvas export-help
logo
Show a SkyCanvas logo.
skycanvas logo
Data Storage
SkyCanvas does not require any external database.
All constellation data is stored locally inside the tool.
No account or cloud synchronization requited whatsoever.
Supported Constellations
SkyCanvas currently includes many popular constellations:
- Orion
- Ursa Major
- Cassiopeia
- Scorpius
- Taurus
- Gemini
- Leo
- Cygnus
- Lyra
- Aquila
- Pegasus
- Andromeda
- Canis Major
- Canis Minor
- Draco
- Sagittarius
- Virgo
- Aries
- Capricornus
- Pisces
- Ursa Minor
- Perseus
- Cepheus
- Hydra
- Centaurus
- Crux
- Phoenix
- Libra
- Aquarius
- Cancer
Technologies
SkyCanvas is build with:
- Python
- Typer
- Rich
- Pillow
- Skyfield
Files
skycanvas/
- main.py
- compare.py
- constellations.py
- coordinates.py
- export.py
- logo.py
- render.py
- tonight.py
Development
Clone repository:
git clone https://github.com/aerissdev-dotcom/SkyCanvas.git
Install dependencies:
pip install -r requirements.txt
Run
skycanvas --help
License
MIT License
Author
aeriss-dev
GitHub:
https://github.com/aerissdev-dotcom
Version
0.1.1
Testing and developing OS
SkyCanvas was developed and tested on macOS. The author does not guarantee full compatibility with every operating system.
OS Compatibility
macOS
Fully tested.
Windows
Should work normally with Python installed.
Linux
Should work normally, but terminal rendering might depend on terminal font support.
Conclusion
SkyCanvas is a small terminal-based astronomy project I created to make exploring the constellations simple and enjoyable.
1 maintainer
Metadata
1 maintainer
Release files for skycanvas 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| skycanvas-0.1.1.tar.gz | 17.0 kB | Without provenance | Details for skycanvas-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| skycanvas-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for skycanvas-0.1.1-py3-none-any.whl |
Total release size: 34.6 kB
Release files / skycanvas-0.1.1.tar.gz
| Download URL | skycanvas-0.1.1.tar.gz |
|---|---|
| Size | 17.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
951754dc906ee5a7b483847d35206cf51823bfa734e59e9a751f841fc87a415a
|
|
BLAKE2b-256 checksum How to use checksums |
2b4c5fd021f789d17d57f53e51c4a66c446c72e76fb026f0df472a4ef133a981
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Release files / skycanvas-0.1.1-py3-none-any.whl
| Download URL | skycanvas-0.1.1-py3-none-any.whl |
|---|---|
| Size | 17.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b0fd4170ec27f2e266fdeababc742930d3e075c34c7aaf45e9fb31c4720f2721
|
|
BLAKE2b-256 checksum How to use checksums |
9267afe2701be7cfe6e8956a981baff4c88bc786bed562bedab2c23cef6fb457
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Security for skycanvas 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
