This repository is to create a container that retrieves JSON data from the aggregators that expose an ADSBExchange-V2 or aircraft.json -style API and sends this data to a server in SBS format.
The container can get the aircraft for multiple "spots" (Lat/Lon/Dist combinations) for a (single) API. If you want to collect data across multiple APIs (for example, from ADSBExchange, Airplanes.live, and adsb.fi), you would have to spin up a separate container instance for each of these APIs.
Currently, only "pull" connections over REST (to get data from the source), and SBS (BaseStation) format "push" connections (i.e., by creating an outbound connection) to your Ultrafeeder/Readsb/dump1090 instance are supported.
See the included docker-compose.yml file for info on how to define and configure the container
The following API services are currently supported:
- ADSBExchange. Use your Feeder UUID as
AUTH_KEY
- Airplanes.live
- adsb.fi
- any
aircraft.json
pull generated by tar1090
It should work with many other APIs that follow the de-facto ADSBExchange V2 standard, but the JSON key names appear to vary. To add a service that uses different keys, please edit the (json_keys
)[scripts/json_keys] file and submit a PR. Please also update this README and the (docker-compose.yml
)[docker-compose.yml] file to reflect and explain the change.
This software is licensed under the Gnu Public License, V3. See LICENSE. Copyright 2025 by Ramon F. Kolb, kx1t