Home

🛰 Sun-Moon Transit Predictor — Wiki

Predicts and detects aircraft — and satellites (ISS, Hubble, Tiangong) — transiting across the Sun and Moon disc from a fixed observer, end-to-end on a Raspberry Pi 5 with dump1090-fa, a web UI, an optional e-paper panel + buzzer, and Pushover alerts.

🚀 Setup, 🛰 Usage, ⚙️ Advanced, 📚 Reference

---

📑 Contents

🚀 Setup — install & run

• Quick start (Raspberry Pi)
• Hardware + software bill of materials
• ADS-B receiver setup (dump1090-fa + AirNav FlightStick)
• Quick install on the Pi 5
• Service control (systemd)
• Updating the service

🛰 Usage — alerts, web UI, display

• Web UI
• E-paper display (optional, v0.31.0)
• Pushover setup & test push
• Satellite transits — ISS, Hubble & Tiangong
  • Can you actually photograph it? — the numbers

⚙️ Advanced — watchlist, triggers, internals

• Predictive watchlist (24 h preview)
• Schedule augmentation (OpenSky, optional)
• SharpCap capture trigger (optional)
• Candidate lifecycle (planned → radio → candidate → imminent → stale)
• How the prediction works
• End-to-end pipeline reference

📚 Reference — config, API, limits, trivia

• Configuration
• HTTP API
• Where files live
• Project layout
• Manual run (development / non-Pi)
• Tests
• Assumptions and limitations
• Status
• Trivia & statistical insights

---

Also: main README · E-paper & buzzer details · 3D-printed stand