Skip to content

Track planes by ICAO, Type, Operator and Squawk and issue notifications on Mastodon, Discord, and Twitter

License

Notifications You must be signed in to change notification settings

nfacha/PlaneAlert

Repository files navigation

wakatime

GitHub tag (latest SemVer) GitHub Release Date GitHub last commit Codacy Badge

GitHub Repo stars GitHub watchers

Discord

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:

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