# Flight Pinger

Mac desktop overflight alert app.

Current revision: `1.0.2` build `3`. See `CHANGELOG.md` and `VERSION.json`.

Double-click `Flight Pinger.app` to run it. The app starts a local server on `127.0.0.1:5177` and shows the alert panel as a desktop overlay at the top of the screen.

The app uses aircraft icons, flipboard sound, and announcement clips. Live aircraft position data from ADSB.lol is proxied through the local Node server so macOS browsers do not hit CORS blocks.

ADSB.lol data is licensed under the Open Database License 1.0. Remote route and aircraft-photo lookups are disabled in this build until separately licensed.

When an aircraft is detected inside the selected flyover range, the overlay slides down from the top of the screen, plays the original `PlaneMarqueeDropSound.mp3`, queues the matching announcement clip when available, holds briefly, then retracts back up.

## Legacy source

The old Windows export is kept separately for safekeeping. The customer launch build is Mac first; Windows can follow later.

## Requirements

- macOS
- Node.js available as `node` on your PATH, `/opt/homebrew/bin/node`, or `/usr/local/bin/node`

If Node.js is missing, the launcher will show a macOS alert instead of silently failing.

The `.app` bundle includes its own copy of the web app and a local `package.json` in `Flight Pinger.app/Contents/Resources`, so Finder launches do not get blocked by macOS Documents-folder privacy rules.
