This script is a companion for standard installs of the ultrafeeder container. You also need a target ntfy server and topic you're subscribed to.
The aircraft that can be seen by the tar1090 application are available at https://tar1090.example.com/data/aircraft.binCraft.zst. This is a compressed binary format. In order to parse this data, I modified the binCraft-decoder library so that it calls this tar1090 API endpoint instead of reading a file.
-
Setup environment
pip install -r requirements.txt -
Set variables in
conf.yml. The default setup is for purely selfhosted tar1090 and ntfy servers available on localhost, and the setup for St Stephen's Green in Dublin. You'll want to change all of those variables.- There's also the
ntfy_numberwhich is meant to notify you when the antenna can see more thatxnumber of planes at once. Check yourgraphs1090info to see what the best number to set there is for you.
- There's also the
-
Run the script. I run it as a cron job scheduled for every minute, you can run it however you want.
In case your tar1090 application is secured by Cloudflare, Fastly, or AWS Cloud Front, you might need to pass some bot manager bypass headers on your requests.
Add your custom headers and the domains to send them too in your conf.yaml.
Integration with my bare bones logging server little logger in baked in. Uncomment and fill out the relevant ENV variables in order to use it.
adsb.lol has a rate limit of 1 req per second if you're not feeding data and 2 if you are. This script is setup so that it never exceeds the 1 req per second limit, leaving you space to run this script as often as you want without interfering with users on your tar1090 web app (which also depends on adsb.lol APIs).