Plane Tracker

A simple python code to track planes and notify you via discord webhooks

Warning

This should be used for your own educational purposes. If you are interested in accessing Flightradar24 data commercially, please contact business@fr24.com. See more information at Flightradar24's terms and conditions.

Setting up

Firstly clone repository and install dependencies:

git clone https://github.com/KonradowyPL/planeTracker.git
cd planeTracker
pip install -r requirements.txt
mkdir dump
touch config.json

Then install FlareSolverr

Configuring:

In config.json add following:

{
  "webhook": "WEBHOOK URL",
  "name": "Plane Spotter",
  "icon": "https://example.com/icon.png",
  "color": "blue",
  "embedColor": "2CA3DA",
  "planes": ["HB-LUN", "HB-LUZ"],
  "font": "/path/to/font.ttf",
  "userAgent": "PlaneTracker/0.0 (example@example.com)",
  "flareSolver": "http://localhost:8191/v1",
  "dump": "FLIGHT,TILE"
}

where:

• webhook is your Discord webhook URL.
• name is the username of your Discord bot.
• icon is the link to your Discord bot avatar.
• color is the color of the plane trace in hex or from Pillow's list of colors. If you remove this field, line color will be calculated according to this
• embedColor is the hex color of the sidebar of the embed. In this case, light blue.
• planes is an array of plane registration numbers that you want to track.
• font is path to ttf font file. If not specifed defeault one will be used.
• userAgent is User-Agent sent with requests to OpenStreetMap. To prevent blocking it is recommended to put here Your contact email.
• flareSolver is link to Your FlareSolverr instance
• dump optional: specifies what requests do dump and cache for future use: FLIGHT will cache all flights, TILE will cache map tiles and ALL which isn't recommended and should be used only when debugging

Running

I recommend launching it via cron every day:

0 23 * * * bash -c 'cd /path/to/planeTracker && python /path/to/planeTracker/main.py' 2>&1 >> /path/to/errors.log

Contributing

Feel free to open issues and make PRs.

License

This repository is under MIT license. See license file.