Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nfacha/planealert
Track planes by ICAO, Type, Operator and Squawk and issue notifications on Mastodon, Discord, and Twitter
https://github.com/nfacha/planealert
adsb adsbexchange discord mastodon mastodon-bot plane radarplane rtl-sdr twitter
Last synced: 1 day ago
JSON representation
Track planes by ICAO, Type, Operator and Squawk and issue notifications on Mastodon, Discord, and Twitter
- Host: GitHub
- URL: https://github.com/nfacha/planealert
- Owner: nfacha
- License: gpl-3.0
- Created: 2022-01-19T20:02:16.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-01-10T20:18:50.000Z (12 months ago)
- Last Synced: 2024-04-13T21:02:54.342Z (8 months ago)
- Topics: adsb, adsbexchange, discord, mastodon, mastodon-bot, plane, radarplane, rtl-sdr, twitter
- Language: TypeScript
- Homepage:
- Size: 864 KB
- Stars: 9
- Watchers: 2
- Forks: 1
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://wakatime.com/badge/user/65ddcee5-893d-45e3-989c-4d52691b9072/project/cb52da0e-7317-4d00-97da-47004445e1f5)
[](https://www.codacy.com/gh/nfacha/PlaneAlert/dashboard?utm_source=github.com&utm_medium=referral&utm_content=nfacha/PlaneAlert&utm_campaign=Badge_Grade)
[](https://discord.gg/ecyK3y4zTW)
# PlaneAlert
## Like this project? Don't forget to STAR it and follow it for future releases :)
## Some Mastodon accounts running PlaneAlert:
[@planeemergency](https://airwaves.social/@planeemergency) - Tracking Aircraft declaring an emergency
[@ryanairtracker](https://airwaves.social/@ryanairtracker) - Tracking Rayanair flights
[@interestingplanes](https://airwaves.social/@interestingplanes) - Tracking the movement of some interesting military
and civilian planes
[@russiatracker](https://airwaves.social/@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