{"id":23360234,"url":"https://github.com/nfacha/planealert","last_synced_at":"2025-04-10T10:32:09.458Z","repository":{"id":50521548,"uuid":"449837867","full_name":"nfacha/PlaneAlert","owner":"nfacha","description":"Track planes by ICAO, Type, Operator and Squawk and issue notifications on Mastodon, Discord, and Twitter","archived":false,"fork":false,"pushed_at":"2024-01-10T20:18:50.000Z","size":885,"stargazers_count":9,"open_issues_count":5,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-04-13T21:02:54.342Z","etag":null,"topics":["adsb","adsbexchange","discord","mastodon","mastodon-bot","plane","radarplane","rtl-sdr","twitter"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nfacha.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2022-01-19T20:02:16.000Z","updated_at":"2024-03-21T10:47:52.000Z","dependencies_parsed_at":"2024-01-13T17:47:11.901Z","dependency_job_id":"d57e905c-1ac4-46e6-bb64-98c6c2645975","html_url":"https://github.com/nfacha/PlaneAlert","commit_stats":{"total_commits":228,"total_committers":4,"mean_commits":57.0,"dds":0.09210526315789469,"last_synced_commit":"cd4c4ed76fd8d4b6fde322dc079f84d5de77e7f3"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nfacha%2FPlaneAlert","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nfacha%2FPlaneAlert/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nfacha%2FPlaneAlert/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nfacha%2FPlaneAlert/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nfacha","download_url":"https://codeload.github.com/nfacha/PlaneAlert/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248199136,"owners_count":21063641,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adsb","adsbexchange","discord","mastodon","mastodon-bot","plane","radarplane","rtl-sdr","twitter"],"created_at":"2024-12-21T11:13:25.739Z","updated_at":"2025-04-10T10:32:09.421Z","avatar_url":"https://github.com/nfacha.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![wakatime](https://wakatime.com/badge/user/65ddcee5-893d-45e3-989c-4d52691b9072/project/cb52da0e-7317-4d00-97da-47004445e1f5.svg)](https://wakatime.com/badge/user/65ddcee5-893d-45e3-989c-4d52691b9072/project/cb52da0e-7317-4d00-97da-47004445e1f5)\n\n![GitHub tag (latest SemVer)](https://img.shields.io/github/v/tag/nfacha/PlaneAlert?label=Latest%20version)\n![GitHub Release Date](https://img.shields.io/github/release-date/nfacha/PlaneAlert)\n![GitHub last commit](https://img.shields.io/github/last-commit/nfacha/PlaneAlert)\n[![Codacy Badge](https://app.codacy.com/project/badge/Grade/c40766e76d3d468b996d23fc7edcfd85)](https://www.codacy.com/gh/nfacha/PlaneAlert/dashboard?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=nfacha/PlaneAlert\u0026amp;utm_campaign=Badge_Grade)\n\n![GitHub Repo stars](https://img.shields.io/github/stars/nfacha/PlaneAlert?style=social)\n![GitHub watchers](https://img.shields.io/github/watchers/nfacha/PlaneAlert?style=social)\n\n[![Discord](https://img.shields.io/discord/933444164379619348)](https://discord.gg/ecyK3y4zTW)\n\n# PlaneAlert\n\n## Like this project? Don't forget to STAR it and follow it for future releases :)\n\n## Some Mastodon accounts running PlaneAlert:\n\n[@planeemergency](https://airwaves.social/@planeemergency) - Tracking Aircraft declaring an emergency\n\n[@ryanairtracker](https://airwaves.social/@ryanairtracker) - Tracking Rayanair flights\n\n[@interestingplanes](https://airwaves.social/@interestingplanes) - Tracking the movement of some interesting military\nand civilian planes\n\n[@russiatracker](https://airwaves.social/@russiatracker) - Planes known to be associated with the #Russian government or\nRussian oligartchs\n\n## Features\n\n- Support multiple data sources (api.facha.dev, OpenSky, Dump1090, RadarPlane or Virtual Radar Server), with an easy way\n  to add your own\n- One instance can track multiple Aircraft\n- Track Aircrafts by ICAO Hex\n- Track whole Airlines\n- Track all aircrafts of a specific type (Like track all B-52s at once)\n- Track all aircraft broadcasting a specific squawk (such as 7500,7600,7700)\n- Send out alerts on Discord, Twitter and Mastodon (with screenshots)\n- Calculate the nearest airport to the aircraft on signal loss\n- Full Docker support\n\n## TrackSources\n\nThe following TrackSources are supported:\n\n- `FachaDev` - This is the default and RECOMMENDED TrackSource, that support all current\n  Features | https://api.facha.dev\n- `VRS` - This connects to your own Virtual Radar Server | (Self-Hosted)\n- `OPSN` - OpenSkyNetwork | (https://openskynetwork.github.io/opensky-api/rest.html)\n- `dump1090` - Dump1090 Aircraft.Json | Get data from your local Dump1090 Feeder\n- `RadarPlane` - RadarPlane.com | (https://radarplane.com/api)\n\nAt this time airlines, squawk and type queries are only supported by the FachaDev TrackSource, and will not work if\nanother source is selected\n\n## Usage\n\n1. Clone the repo and cd into its directory\n2. On the `config` folder copy the `main.yaml.example` as `main.yaml` and edit it to your needs\n3. On this same `config` folder you will see four folders `aircraft`, `airlines` and `squawk`, and `types`, all this\n   folders will contain an example file, to add a track of that type you just need to copy that file over and adjust its\n   settings as needed\n4. Run `docker-compose up -d` to start the services\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnfacha%2Fplanealert","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnfacha%2Fplanealert","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnfacha%2Fplanealert/lists"}