/OverPutney

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

Primary LanguagePythonMIT LicenseMIT

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.
  • Adds destination and origin airports where available, using new APIs from Josh.

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.

Note: the default state of the launcher now runs without writing to nohup.out as this can get large over time. Swap the commented out lines to get an output for debugging.

Forked from the AboveTustin code written by