# Jxck-S/plane-notify

Real-time ADS-B notifications for specific aircraft takeoffs and landings. Supports output many platforms.

Repository: https://github.com/Jxck-S/plane-notify
Canonical: https://ross.abutalabs.com/products/plane-notify
Homepage: https://grndcntrl.net/
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: ads-b, adsb, plane, airport, land, takeoff, tcas, acas, resolutionadviosry, squawk, emergency-squawk, elonjet
Last push: 2026-02-05T05:52:03+00:00

## Health v2 (maintenance only)
Score: 62/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 66, release rhythm 35, longevity 100
- inputs: {"age_days": 2277, "days_push": 209, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2544, forks 422 (observed 2026-08-28T04:06:59.527449+00:00)

## What it is
A Python application that monitors ADS-B flight data from OpenSky or ADSBExchange and sends notifications when configured aircraft take off or land, including reverse-geocoded locations and map screenshots. It supports output to many platforms such as Discord, Twitter, and Telegram, and was originally built to track Elon Musk's private jet.

## Use cases
- get notified when a specific plane takes off or lands
- track a private jet's movements in real time
- post automatic flight updates to Discord or Twitter
- monitor emergency squawks from aircraft
- run a flight-tracking bot for an aviation community
- log takeoff and landing locations for specific aircraft

## When to choose
- you want self-hosted real-time notifications for specific aircraft
- you need multi-platform output (Discord, Twitter, Telegram, etc.)
- you want to use free OpenSky data or have an ADSBExchange API key
- you're running a public flight-tracking account or bot

## When to avoid
- you need a polished GUI flight-tracking dashboard rather than notifications
- you can't run a persistent Python process or Docker container
- you need guaranteed low-latency commercial-grade tracking data
- you only need historical flight data rather than live alerts

## Facets
- artifact type: application
- maturity: active
- function: monitoring, alerting, webhook, workflow-automation, data-science
- domain: developer-tools, analytics
- platform: python, self-hosted
- tags: ads-b, flight-tracking, opensky, adsbexchange, discord-notifications, twitter, telegram, aviation, elonjet, notifications, real-time, automation, linux, docker

## Member repositories
- Jxck-S/plane-notify (main) score 62

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:59.527449+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:25:03.799731+00:00, confidence not recorded.
  - readme: https://github.com/Jxck-S/plane-notify (fetched 2026-08-28T04:06:59.527449+00:00, sha b0f559ed066b)
  - homepage: https://grndcntrl.net/ (fetched 2026-08-29T10:07:03.781306+00:00, sha d4bc1a50a5e2)
  - site_page: https://grndcntrl.net/about (fetched 2026-08-29T10:07:03.790406+00:00, sha 1e1e043efd27)
- Data as of 2026-08-30T08:39:29.467469+00:00.