Home
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, ❓ FAQ
New here and something's not working? Jump straight to ❓ FAQ & Troubleshooting — checking dump1090, empty plane lists, no alerts, updating.
- 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
- Web UI
- E-paper display (optional, v0.31.0)
- Pushover setup & test push
- Satellite transits — ISS, Hubble & Tiangong
- Sky-target passes — satellite × deep-sky object
- 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
- Configuration
- HTTP API
- Where files live
- Project layout
- Manual run (development / non-Pi)
- Tests
- Assumptions and limitations
- Status
- Trivia & statistical insights
Subscribe with just your location to get a Pushover 24–48 h before the ISS, Hubble or Tiangong crosses the Sun or Moon at your site — exact second, promo link, one-click unsubscribe. No account needed. Runs as a GitHub Actions cron worker (3×/day) that re-uses this repo's prediction engine read-only (nothing in src/ changes); signup page hosted on GitHub Pages, subscribe/confirm/unsubscribe via Supabase Edge Functions.
Also: main README · E-paper & buzzer details · 3D-printed stand · public transit-alert signup ↗