PlaneAlert

Like this project? Don't forget to STAR it and follow it for future releases :)

Some Mastodon accounts running PlaneAlert:

@planeemergency - Tracking Aircraft declaring an emergency

@ryanairtracker - Tracking Rayanair flights

@interestingplanes - Tracking the movement of some interesting military and civilian planes

@russiatracker - Planes known to be associated with the #Russian government or Russian oligartchs

Features

• Support multiple data sources (api.facha.dev, OpenSky, Dump1090, RadarPlane or Virtual Radar Server), with an easy way to add your own
• One instance can track multiple Aircraft
• Track Aircrafts by ICAO Hex
• Track whole Airlines
• Track all aircrafts of a specific type (Like track all B-52s at once)
• Track all aircraft broadcasting a specific squawk (such as 7500,7600,7700)
• Send out alerts on Discord, Twitter and Mastodon (with screenshots)
• Calculate the nearest airport to the aircraft on signal loss
• Full Docker support

TrackSources

The following TrackSources are supported:

• FachaDev - This is the default and RECOMMENDED TrackSource, that support all current Features | https://api.facha.dev
• VRS - This connects to your own Virtual Radar Server | (Self-Hosted)
• OPSN - OpenSkyNetwork | (https://openskynetwork.github.io/opensky-api/rest.html)
• dump1090 - Dump1090 Aircraft.Json | Get data from your local Dump1090 Feeder
• RadarPlane - RadarPlane.com | (https://radarplane.com/api)

At this time airlines, squawk and type queries are only supported by the FachaDev TrackSource, and will not work if another source is selected

Usage

1. Clone the repo and cd into its directory
2. On the config folder copy the main.yaml.example as main.yaml and edit it to your needs
3. On this same config folder you will see four folders aircraft, airlines and squawk, and types, all this folders will contain an example file, to add a track of that type you just need to copy that file over and adjust its settings as needed
4. Run docker-compose up -d to start the services