App/planes overhead

[InertiaImpact]

This is reliant on #16 being merged first as it makes use of the advanced settings features introduced in that PR.

I can rebase if needed after #16 is merged if it will make things easier.

Planes Overhead App

This PR adds a comprehensive multi-provider aircraft tracking app to SplitFlap OS.

Features

• Multi-provider support: Fetch nearby aircraft from OpenSky, FlightAware AeroAPI, Flightradar24, AirLabs, or Aviationstack
• Flexible configuration:
  • Custom location (lat/lon) and search radius (miles or kilometers)
    Default location set to ORD Airport for high traffic example.
  • Adjustable polling rate and dwell time per flight
  • Maximum flight display limit with cycling
  • Units preset (aviation, metric, imperial) or custom
• OpenSky OAuth2 support: Client credentials authentication with automatic token refresh; falls back to free anonymous tier when no credentials are provided
• Smart polling: Plugin-local state tracking prevents redundant API calls when settings haven't changed; respects per-provider rate limits
• Robust error handling: Provider-specific error pages for auth failures, rate limits, timeouts, and other API issues
• Clean display: Shows callsign, distance, altitude (FL/feet/meters), heading, and speed for each aircraft

Implementation Details

• Settings-driven configuration with conditional visibility (e.g., API keys only show when that provider is selected)
• In-app polling state to support save-triggered refresh without server-side cache hooks
• Haversine distance calculation and bearing/cardinal direction computation
• Graceful degradation when providers are unavailable

• Default provider is OpenSky with a anonymous API, settings will warn if you set refresh higher than your daily limit on the free tier.

  

Files

• apps/planes_overhead/app.py — Provider clients, data parsing, formatting
• apps/planes_overhead/manifest.json — Settings schema with defaults and provider toggles
• apps/registry.json — App registration entry

[csader]

Nice app! The code looks solid.

Since PR #16 is now merged, this PR has duplicate changes in server/app.py, app.js, styles.css, README.md, and APPS_README.md that will conflict. Can you rebase on latest main?

git fetch upstream
git rebase upstream/main
git push --force-with-lease origin app/Planes_Overhead

After that we can merge cleanly. The only new files should be apps/planes_overhead/ and the registry.json entry.

[InertiaImpact]

Nice app! The code looks solid.

Since PR #16 is now merged, this PR has duplicate changes in server/app.py, app.js, styles.css, README.md, and APPS_README.md that will conflict. Can you rebase on latest main?

git fetch upstream
git rebase upstream/main
git push --force-with-lease origin app/Planes_Overhead

After that we can merge cleanly. The only new files should be apps/planes_overhead/ and the registry.json entry.

Should be rebased with just the 2 new files and the registry addition.