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
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.