PlaneAlert

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

@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

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

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

Clone the repo and cd into its directory
On the config folder copy the main.yaml.example as main.yaml and edit it to your needs
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
Run docker-compose up -d to start the services