louwng/overputney

An ADS-B twitterbot written in Python for use with Piaware systems with the tar1090 mapping tool.

OverPutney

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.

Dependencies

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

Notes

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.

Forked from the AboveTustin code written by

• Kevin Brandon
• Joseph Prochazka