SkyFollower

SkyFollower is a locally-hosted ADS-B aircraft tracking system. It ingests, enriches, and archives flight data from one or more readsb decoders, evaluates configurable alert rules, and publishes notifications over MQTT — alongside a live map and web UI for watching traffic in real time.

Full documentation: brentio.github.io/SkyFollower

• Getting Started — bring up each host and do a first-time data load
• Deployment — host topology, compose files, components, and configuration reference
• Architecture — pipeline diagram plus scaling message processors horizontally
• Rules & Areas — condition types, example rules.json/areas.json
• Data Runners — settings fields for every registration/airport data source
• MQTT Reference — every topic published, including Home Assistant autodiscovery behavior

License

SkyFollower is licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later) — see LICENSE. Contributions are accepted under the same license; see CONTRIBUTING.md.

Third-party components carry their own licenses, several of them also copyleft (for example pyModeS, GPL-3.0) — see THIRD-PARTY-NOTICES.md.