esp32flight v0.2.2

Busy-airspace release. Tested over Washington DC with 130+ aircraft in range; several limits that were invisible over quieter skies turned out to matter.

Data and coverage:

• When the area has more aircraft than the list fits (now 80), the NEAREST ones are kept; previously the first 40 in API response order were taken, which could bias the picture to one side of the sky
• Ground and non-airline traffic no longer wastes list slots when the filters are on
• Route lookups now cover the whole list (previously only the 10 nearest), 8 per cycle, with a 160-entry cache in PSRAM; airline names fill in faster too
• Failed lookups (timeouts, rate limits) retry after a minute instead of being cached as "no route" for 30 minutes
• New route sources: adsb.lol routeset as a second opinion, and when a FlightAware key is set, the live origin/destination from AeroAPI is used at no extra API cost
• Flight list shows the 40 nearest aircraft (scrollable)

Screensaver and maps:

• The observation circle spans the full screen height and every aircraft in range is drawn on it, with overlap-free info bubbles
• Tap a plane on the screensaver to see its bubble; tap the background to close
• Tile zoom raised to 11 and the map is pre-scaled once in a worker, so it is noticeably sharper and cheaper to render
• Tiles are cached in PSRAM (LRU, ~1.5 MB): repeat map opens are instant and survive short outages, with an automatic retry when a fetch fails
• Radar view draws all aircraft in range, not just the list

Stability and visibility:

• LVGL widget allocations moved to PSRAM; internal RAM exhaustion could previously prevent the map workers from starting
• Internal RAM metrics in /metrics and in the web panel Network card
• Alert history: every notification (emergency squawk, watchlist, flyover) is logged to flash and browsable in the panel History tab (/api/alerts)
• Detail view: local times sit next to the airport codes, and a new bottom line shows squawk, ADS-B category and the estimated local arrival time
• Stats view layout fixes (METAR one line without remarks, six top airlines)

OTA update from v0.2.1 is enough for all of the above. Flash from the browser: https://theqkash.github.io/esp32flight/

esp32flight v0.2.1

Quality and documentation release.

On the device:

• Country flags: origin and destination airports and the aircraft registration show their national flags (252 flags bundled in the assets partition)
• The map screensaver draws your observation circle and home point, so it is clear where the watched area ends
• Compact spotter line when a flyover prediction is shown, no more truncated text
• Integration fields in the device settings got short hints explaining each one

Web panel:

• Reorganized into tabs: Live, History, Settings, API
• New API tab: full HTTP API reference with curl examples (/api/state, /api/config, /api/log, /screen.bmp, /metrics, /ota, webhook payload)
• Settings form rebuilt into sections with per-field help texts: how to set up ntfy.sh push, MQTT and Home Assistant, FlightAware flight numbers, webhooks and a local dump1090/readsb receiver
• Night mode times are regular time pickers now instead of minutes from midnight
• Optional panel password: HTTP Basic Auth (user admin) protecting the panel and every API endpoint; set in the web or device settings, empty means open as before
• The Save button stays disabled until the current config loads, so a half-loaded form can never overwrite settings
• Clicking a plane on the map shows a single route line that follows the aircraft between refreshes

Notes:

• The flags live in the assets partition, so they arrive with the full image (browser installer or serial flash). An OTA update alone works fine but shows no flags until the full image is flashed once.
• The README now documents every integration step by step plus the whole HTTP API.

Flash from the browser: https://theqkash.github.io/esp32flight/

esp32flight 0.2.0

Big feature release.

Maps and views:

• Real zoomed tile maps (CARTO) on the route map, ambient view and radar
• Radar shows the local area map with aircraft at true positions
• Flight trails, altitude-colored rotating plane markers
• Map pan (swipe) and manual zoom, full-screen map screensaver after idle
• Session stats view with hourly chart, top airlines, METAR and daily records

Spotter tools:

• Where-to-look line: compass direction + elevation above the horizon
• Flyover prediction (CPA) with push alerts for interesting aircraft
• Watchlist and military highlighting, registration country codes

Data and integrations:

• Local dump1090/readsb receiver support (LAN aircraft.json), API fallback
• Bundled OurAirports database, position-validated route lookups
• ntfy.sh push, MQTT with Home Assistant discovery, generic webhooks
• Optional FlightAware AeroAPI for commercial (IATA) flight numbers
• Local airport times, night mode with quiet hours

Device and web:

• Tabbed on-device settings with every option, first-boot setup screen
• Web panel: full device settings, spotting history with CSV export,
  daily stats chart, trails and country flags, Prometheus /metrics
• OTA updates locked behind an on-device switch, update checker

Flashing: browser at https://theqkash.github.io/esp32flight/ or
esptool --chip esp32s3 write_flash 0x0 esp32flight-v0.2.0-full.bin

esp32flight 0.1.0

First release.

Standalone flight radar for the Waveshare ESP32-S3-Touch-LCD-7 (800x480).

Highlights:

• Live ADS-B flight list (airplanes.live / adsb.lol) with airline logos
• Routes with cities, countries and local airport times, position-validated across adsbdb and hexdb
• Flight detail view with ETA, aircraft photos, full-screen route map
• Ambient auto-cycling mode with map and info bubble, radar view
• Weather in the header (Open-Meteo), emergency squawk alerts
• Touch settings: Wi-Fi scan, city search, radius, filters, 7 themes, EN/PL
• Web panel (http://esp32flight.local): live table, Leaflet map, stats, screenshots, OTA updates

Flashing:

• Browser: https://theqkash.github.io/esp32flight/ (Chrome/Edge)
• esptool: esptool --chip esp32s3 write_flash 0x0 esp32flight-v0.1.0-full.bin
• Updates over the air: upload the OTA image on the device web panel