OverPutney is an ADS-B Twitter Bot running on a Raspberry Pi 4. It tracks airplanes and then tweets whenever an airplane flies overhead. It is a fork of the original AboveTustin bot, modified to work on a Piaware with Flightaware's fork of dump1090 and adding support for Josh Douch's free ICAO lookup APIs. It also uses chromedriver for browser interactions rather than the deprecated PhantomJS webdriver.
- Uses tar1090 for ADSB message decoding, airplane tracking, and webserving.
- Built on the Flightaware Piaware distribution.
- Works with Chromium chromedriver webdriver on Raspberry Pi.
- It tweets an image of a map with the airplane's track and the decoded aircraft data displayed by tar1090.
- It displays the flight name if available, or the reported icao code.
- It displays altitude, ground speed and heading information of the airplane at it's closest point to the bot.
- Gives different hashtags depending on altitude, speed and time of day.
- Adds aircraft registration, type, and owner using Josh Douch's ICAO hex lookup APIs.
- Uses tar1090 for ADSB message decoding, airplane tracking, and webserving.
- Uses twitter for tweeting.
- Uses selenium for screenshots with Chromedriver and Chromium.
- Uses pillow for image processing.
- Uses requests for API calls.
- Uses Chromedriver for headless web browsing.
- Builds on a running Piaware Raspberry Pi-based ADS-B receiver and decoder with MLAT support, with web server and local databases.
Add your Twitter keys and location in lat/long to config
and rename as config.ini
before running. The ./runbot.sh
script will launch the looping script run_tracker.sh
(which ensures the tracker python code is running) as a background task with no interaction. Use tail -f nohup.out
to monitor operations. pkill -f tracker
will shut down the bot.