How hhaider3/live-sat-location works
Earth Orbit Live is a browser-based 3D satellite explorer backed by a small Cloudflare Worker API. The main workflow loads observed orbital catalogs, parses them into satellite state, propagates positions for the interactive globe, and lets users search/select satellites or plan city passes. The Worker validates upstream CSV/OMM data and serves cached observations with snapshot fallbacks. The README documents additional UI and resilience capabilities beyond the sampled excerpts; edges for unsampled wiring are omitted or marked unverified.
Main entry points: App.tsx Explorer interface · proxy.js Catalog proxy · engine.ts 3D globe and controls · satellites.ts Catalog loading
Components 24
Browser experience
- Explorer interface
src/App.tsx - Pass planner
src/PassPlanner.tsx - Catalog loading
src/satellites.ts - Batch scheduler
src/catalog.ts - Catalog parser
src/catalogParser.ts - Parse worker
src/catalog.worker.ts
Orbit calculations
- 3D globe and controls
src/engine.ts - Orbit propagation
src/propagation.ts - Propagation worker
src/propagation.worker.ts - Pass prediction
src/passes.ts - Pass worker
src/passes.worker.ts - Satellite model
src/satellites.ts - Simulation clock
src/time.ts - Satellite picking
src/picking.ts
Catalog API
- API router
worker/index.js - Catalog proxy
worker/proxy.js
Catalog validation and storage
- OMM CSV parser
shared/csv.ts - OMM validation
shared/omm.ts - Snapshot validation
shared/snapshot.ts - Snapshot service
worker/snapshot.js - Catalog storage
worker/store.js
Other components
- Explorer
- CelesTrak
- Hosted snapshot
public/data/active.json
Connections 26
- Explorer → Explorer interface: uses
README.md - Explorer interface → Catalog loading: loads groups
src/App.tsx - Explorer interface → Batch scheduler: schedules loads
src/App.tsx - Explorer interface → Catalog parser: configures parsing
src/App.tsx - Catalog parser → Parse worker: parses off-thread
- Catalog loading → API router: requests catalog
README.md - Explorer interface → 3D globe and controls: controls display
src/App.tsx - Explorer interface → Pass planner: renders planner
src/App.tsx - Pass planner → Pass prediction: requests predictions
src/PassPlanner.tsx - Pass prediction → Satellite model: uses orbit data
src/PassPlanner.tsx - Pass prediction → Pass worker: runs in worker
src/passes.worker.ts - 3D globe and controls → Orbit propagation: requests snapshots
src/engine.ts - 3D globe and controls → Satellite model: samples orbits
src/engine.ts - 3D globe and controls → Simulation clock: advances time
src/engine.ts - 3D globe and controls → Satellite picking: picks satellites
src/engine.ts - Propagation worker → Orbit propagation: builds snapshots
src/propagation.worker.ts - Orbit propagation → Satellite model: propagates records
src/propagation.ts - API router → Catalog proxy: routes requests
worker/index.js - Catalog proxy → OMM CSV parser: parses feed
worker/proxy.js - Catalog proxy → OMM validation: validates records
worker/proxy.js - Catalog proxy → Snapshot service: loads snapshots
worker/proxy.js - Catalog proxy → Catalog storage: reads and writes
worker/proxy.js - Catalog proxy → CelesTrak: fetches feed
README.md - Snapshot service → Snapshot validation: validates snapshot
worker/snapshot.js - Snapshot service → Hosted snapshot: reads asset
worker/snapshot.js - Catalog loading → Hosted snapshot: fallback fetch
README.md