Radar

Real-time ADS-B aircraft tracker. Displays an interactive map of aircraft received from a local ADS-B feeder (e.g. readsb/dump1090 JSON endpoint) and enriches flights with route, airline, and aircraft type metadata from the public adsbdb.com API.

Features

• Live map of aircraft with position, altitude, speed, heading
• Flight route enrichment (origin / destination / airline)
• Aircraft type and registration lookup
• In-memory caching with TTL to minimise API calls
• OTP email-based auth via a shared-auth module

Configuration

Copy the example PM2 file and fill in the values:

cp ecosystem.config.example ecosystem.config.cjs

Edit server.js to point FEEDER_URL at your local ADS-B feeder and set receiver coordinates to your antenna location.

Required env vars (consumed by the shared OTP auth module):

• OTP_JMAP_URL, OTP_JMAP_USER, OTP_JMAP_PASS - JMAP server for sending OTP emails
• OTP_FROM_EMAIL - From address for OTP mail
• OTP_SESSION_SECRET - random 32+ byte secret
• OTP_ALLOWED_EMAILS - comma-separated allowlist
• OTP_INTERNAL_API_KEY - shared key for internal endpoints

Install & Run

npm install
npm start

Or with PM2:

pm2 start ecosystem.config.cjs

The app listens on port 3013 under /Radar.

License

MIT