Skip to content

🌌 Explore the night sky with free astronomy tools: logbooks, guidance apps, and astrophotography utilities

License

Notifications You must be signed in to change notification settings

stanlm105/MessierExplore

Repository files navigation


MessierExplore

Free Astronomy Tools & Mini-Projects β€” explore the night sky with smart, beginner-friendly utilities.

Made with Python License: MIT Status Last Commit Contributions welcome FastAPI Cloud Run Open-Meteo


Hi, my name is Mike. MessierExplore is a personal astronomy journey turned open toolkit β€” offering logbooks, sky guidance, and astrophotography utilities. Free, beginner-friendly, and built with python + sqlite for local; then live-linked below are also containerized Flask backend deployed to Cloud Run and Cloud Sql on GCS (private VPC and least-privilege IAM).

There are many astro tech choices and methodologies to choose from, which makes for a very deep journey! I hope to cover several avenues over time, but for now, the exploration here leans towards the classic dobsonian telescope and the 110 Messier Objects.

The suggested first quest in this journey is the Messier Observing Program for logging and sketching the 110 Messier objects of the night sky, with log book and assisted guidance computer below.


Quick Links


Tools for Everyone

One page, easy access. No install required.

1) Messier Observing Logbook (Web App -> PDF)


  • What it is: Printable logbook with the 110 Messier objects.
  • Get your personalized PDF Free: https://logbook.messierexplore.com
  • Code: Located in this repository as a python command-line script, and then as a cloud deployed web service.
  • Features: personalized cover page, tracking checklist, per-object log pages, sketch area, clean typography.

2) Messier Target Guidance Computer (Web App: Container, Cloud Run, Cloud SQL)


  • πŸ“ Inputs: location, passphrase
  • πŸ“Š Outputs: live-conditions-adjusted ranked list of suggested Messier targets at your location + explanations
  • 🌐 Try it: https://tgc.messierexplore.com

πŸš€ Why Target Guidance Computer is Exciting
The Target Guidance Computer is more than a Messier checklist – it’s a smart companion that combines astronomy math with real-world conditions.
✨ Shows you what you haven’t logged yet
πŸŒ™ Highlights which objects sit high and clear of the Moon
☁️ Explains how tonight’s clouds, darkness, and sky quality affect your session; dew risk and heat/shield assessment too.

Minimalist design so you're up and running in seconds, with your approximate location, the tool personalizes your observing journey, tracks your β€œseen” list, and serves up the conditions and best targets for tonight at 9 PM local time. πŸ’‘ Lightweight, free, and built to grow – practical backend engineering powering human-friendly exploration of the night sky.

3) Dobsonian Astrophotography β€” Simple Stacking Utils (CLI, GUI.. tbd)

  • What it is: Lightweight, beginner-friendly image stacking pipeline for Dobsonian + MFT DSLR. For myself I'm planning micro four thirds DSLR size to keep size and weight down. While dobsonian is not expected to be top choice for astrophotography, it is nice for live photon-to-eyeball observing and I'm exploring the capture of this.
  • Download: (link to release binary or quickstart)

Want something added? Open an issue with feature ideas ✨


Code & Repo Structure

β”œβ”€β”€ assets/          # template pdfs employed by the logbook
β”œβ”€β”€ data/            # messier object list, temporary sqlite db for playing (a production env would employ a cloud sql backend)
β”œβ”€β”€ docs/            # license and manuals (work-in-progress)
β”œβ”€β”€ output/          # the output folder of personalized logbooks if running logbook locally by commandline
β”œβ”€β”€ services/        # web services of all tools (logbook, target guidance computer)
β”œβ”€β”€ static/          # static images in a folder accessible by the web services
β”œβ”€β”€ tests/           # pytest test suite
β”œβ”€β”€ tools/           # cli version of tools as command line apps (logbook)
└── utils/           # shared logic for tools that come in web service and also commandline flavors 

Project Roadmap

Quest 1: Messier Observing Program

  • YouTube Channel (journey to Astronomical League certification)
  • Messier Logbook Generator (Docker / GCS / Cloud Run)
  • Messier Target Guidance Computer (location-based, Cloud Run + SQL)

Quest 2: Dobsonian Astrophotography

  • Image Stacking Pipeline Utilities (Dobsonian + MFT DSLR)

πŸ“„ License

  • Code: MIT (see LICENSE)
  • Documentation/screenshots: CC BY 4.0 (see docs/LICENSE)
  • Logo: All Rights Reserved (contact for permission)

⭐ If you like this project, give it a star and follow along β€” more tools are on the way!

About

🌌 Explore the night sky with free astronomy tools: logbooks, guidance apps, and astrophotography utilities

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published