# plane-notify
> Get notifications when selected aircraft take off or land using ADS-B data

## Summary
Aircraft tracking tool that sends notifications via Discord, Telegram, or Mastodon when selected planes take off or land using ADS-B data.

## Capabilities
- Track specific aircraft by registration or ICAO hex code
- Detect takeoffs and landings using ADS-B data
- Send notifications to Discord, Telegram, and Mastodon
- Generate maps showing aircraft location on takeoff/landing
- Monitor emergency squawk codes and resolution advisories
- Track multiple planes with individual configuration files
- Reverse geocode coordinates to location names

## When to Use
- When you want to track specific aircraft movements in real time
- When you need automated alerts for plane takeoffs and landings
- When monitoring aviation activity for specific tail numbers

## When NOT to Use
- When you need a general flight search engine for commercial flights
- When you need real-time radar-style display of all aircraft
- When you do not have access to ADS-B data sources

## Usage Patterns
### Run the notifier
```
python plane-notify.py
```
Starts monitoring configured aircraft and sending notifications

## Installation
- **pip**: `pip install -r requirements.txt (after git clone)`

## Related Tools
- [flight-tracker](/tools/flight-tracker) (complementary): flight-tracker animates flight paths in the terminal

---
Source: https://littlescripts.sh/tools/plane-notify