Repository navigation
PyAerial 0.22.0 - integrity checks and research archive
Originally released 2026-10-27.
Breaking changes
- The SQLite archive now includes schema version tracking via
PRAGMA user_version. Archives generated by version 0.21.0 will be rejected until recreated usingpyaerial reset --yes, as automatic migrations are not provided across this boundary. - General flight retention defaults to archiving all observed flights having at least
archive.min_positionssamples (archive.flights: all), rather than saving only flights matched by an alert rule. To restore the previous selective behavior, setarchive.flights: rules. - dump1090 receivers now default to Beast binary format unless connected to port 30002. If you are serving AVR text over a non-standard port, explicitly specify
format: avr. The sample configuration file has been updated to connect to Beast on port 30005.
Added
- Introduced a built-in integrity monitoring engine configured under
integrity, which continuously scores aircraft from 0 to 1 (ok,suspect, orspoofed) across physical and protocol checks. Checks cover angle of arrival, TDOA multilateration with automatic receiver clock synchronization, signal strength decay curves, line-of-sight radio horizons, Mode S altitude corroboration, transmission intervals, kinematics, packet replays, duplicate ICAO detection, shared-emitter clustering, and FAA registration lookups. - Added optional cross-network verification via
integrity.cross_network(targeting adsb.lol by default), querying an external aggregator to confirm whether reported aircraft positions match wider network observations. - Geofence rules can now evaluate an aircraft's
integrityscore directly withinwhencondition blocks. - Added antenna position modeling for receivers, supporting fixed
positioncoordinates, automatic polling viaposition_url(which queries dump1090'sreceiver.jsonbefore falling back tohome), and antenna elevation settings viaantenna_height. - Introduced the
aoareceiver driver for ingesting angle-of-arrival sidecar streams. - Added comprehensive provenance tracking to the research archive, logging detecting receivers and active integrity verdicts alongside each telemetry sample, recording verdict transitions in an
integritytable, and optionally saving all raw receiver frames whenarchive.raw_framesis enabled. - The web portal displays integrity status badges in flight lists, adds an integrity inspector drawer, styles aircraft tracks according to trust, and displays multilaterated transmitter markers when spoofing is detected.
Changed
- The
/ws/rawWebSocket returns a structured JSON stream containing engine receive timestamps and the full list of detecting receivers for each frame, feeding the portal's Raw viewer. The/ws/beaststream and Beast TCP feed remain binary Beast feeds. - The web map has been migrated entirely to MapLibre GL, removing Leaflet and reducing the client bundle size. Flight list sorting controls have been streamlined.
Full changelog: v0.21.0...v0.22.0