Notify if configured planes have taken off or landed using Python with OpenSky(free) or ADSBExchange Data(paid, declining data, and run by clowns), outputs location of takeoff location of landing and takeoff by reverse lookup of coordinates.
I made this program so I could track Elon Musk's Jet and share his whereabouts with others orginally on Twitter (but now suspended, but now also on other platforms). I have now expanded and run multiple accounts for multiple planes, a list of the accounts can be found here https://grndcntrl.net/links
I'm open to any help or suggestions, I realize there are many better ways to improve this program and better ways to get this program to work properly, I'm only a noob. I'll accept pull requests. If you'd like to discuss join https://discord.gg/groundcontrol
- Install using the following steps or use Docker, scroll down to the Docker section.
apt update
apt install python3
apt install python3-pip
pip install pipenv
pipenv install
Selenium/ChromeDriver is used to take a screenshot of the plane on globe.theairtraffic.com. Or use Google Static Maps, which can cost money if overused(No tutorial use https://developers.google.com/maps/documentation/maps-static/get-api-key to get to a key).
- This is assuming linux/debian
curl -sSL https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add
echo "deb [arch=amd64] https://dl.google.com/linux/chrome/deb/ stable main" > /etc/apt/sources.list.d/google.list
apt update
apt install google-chrome-stable
These output methods once installed can be configured in the planes config you create, using the example plane1.ini
apt install screen
apt install git
git clone -b multi --single-branch https://github.com/Jxck-S/plane-notify.git
cd plane-notify
- Copy
mainconf.ini.example
tomainconf.ini
andCopyplane1.ini.example
toplane1.ini
.plane1.ini
can change names as long as it ends with the ini extension - Edit them with nano or vi on the running machine or on your pc and transfer the config to where you will be running the bot
- Pick between OpenSky and ADS-B Exchange
- The OpenSky API is free for everyone but the data is not as good as ADS-B Exchange. The ADS-B Exchange API is not free and this program will not work for the Rapid API from ADS-B Exchange. It only works with the API that they give when you have a partnership with ADS-B Exchange. It is not cheap to get the ADS-B Exchange full API, Don't contact them unless you are ready to pay.
- If you'd like to add support for ADS-B Exchanges RapidAPI feel free to work on it and submit a merge request.
- If you've set up multiple planes and want to use ADSB Exchange as your source you must have /all endpoint access to their API or it won't work.
- Pick the correct API version for ADS-B Exchange.
- Proxy is if your running multiple programs that use the ADSB Exchange, setup the proxy from lemonodor so you don't abuse the ADSB Exchange API, otherwise leave enable false.
- When using OpenSky there are more bugs because I mainly use ADS-B Exchange and work less on the OpenSky Implementation.
- An example file is given (plane1.ini) plane config files should be in the configs directory, the program looks for any file in that folder with a .ini extension.
- Each plane should have its own config
screen -R <name screen whatever you want>
pipenv run python __main__.py
Install docker from their website. Run the following command from the root of the project.
docker-compose up -d
After running this command, due to the -d
flag the container will be running in the background. To see the logs of the docker container use docker logs CONTAINER
(add -f
to continue streaming the containers output)
Data obtained can be sent through Telegram to a chat (contact), channel or groups.
Creating a Telegram Bot
- Start a conversation with BotFather;
- Send it to the BotFather: /newbot
- Choose a name for your bot;
- Choose a username for your bot;
- Done! You'll get a token to access the HTTP API.
Getting channel or chat (contact) ID
- Start a conversation with JsonDumpBot;
- It will reply with a json with information from the message;
- Go to the channel or chat you want the id and forward a message from there to JsonDumpBot;
- Find the id in the reply. It'll look something like this:
{...
"forward_from_chat": {
"id": xxxxxxxxx,
...}
- Don't forget to add the bot as admin in channel so messages can be sent.
Getting a group ID
- Open Telegram web;
- Go to group and check the url on address bar of browser;
- That's the group ID (-xxxxxxxxx), it'll look something like this:
https://web.telegram.org/z/#-xxxxxxxxx
- General Cleanup
- Restructure project to make it proper currently random files because I didn't know how to properly structure a project before. (in progress)
- Add proper logging and service to run the program and remove excessive printing.
- Better single config YAML, or DB maybe