Skip to content

FlightAbove transforms your Mac's menu bar into a real-time aviation radar, showing you exactly what aircraft are flying nearby.

License

Notifications You must be signed in to change notification settings

supercmder/FlightAbove

 
 

Repository files navigation

FlightAbove

Build License Latest Release Platform Stars Forks

A modern macOS menu bar application that displays nearby aircraft with real-time flight information, comprehensive credit management, and a beautiful interface designed for aviation enthusiasts.

FlightAbove Main App

โœจ Features

  • Real-Time Flight Tracking - Detect aircraft within 10-50km radius
  • Aircraft Images - View real photos of detected aircraft via JetAPI
  • Rich Flight Data - Flight numbers, airlines, routes, altitude, speed
  • 1,224+ Airlines - Global coverage with professional logos
  • Demo Mode - Test without API keys using realistic flight data
  • Smart Caching - Efficient performance with intelligent data caching
  • Native macOS UI - Clean, minimalist menu bar interface

๐Ÿš€ Quick Start

For Users

  1. Download the latest release from Releases
  2. Open the DMG and drag to Applications
  3. Launch FlightAbove from your menu bar

For Developers

git clone https://github.com/LouisXO/FlightAbove.git
cd FlightAbove
npm install
npm run dev

๐Ÿ“‹ Requirements

  • macOS 10.14 or later
  • Internet connection
  • IP-based location services (no GPS required)

๐ŸŽฎ Usage

  1. Launch FlightAbove from Applications
  2. Click the menu bar icon to view nearby aircraft
  3. Navigate through multiple flights with arrow keys
  4. View comprehensive flight information and aircraft images
  5. Configure settings via the gear icon

Menu Bar Indicators

  • โœˆ๏ธ - No flights detected
  • UA1234 - Single flight (shows flight number)
  • UA1234+2 - Multiple flights (shows closest + count)

๐Ÿ› ๏ธ Development

Scripts

npm run dev          # Start development environment
npm run build        # Build for production
npm run dist         # Package for distribution
npm run lint         # Run linting
./scripts/version.sh patch  # Bump version

Tech Stack

  • Frontend: React 18 + TypeScript
  • Backend: Electron
  • Build: Vite
  • APIs: FlightRadar24, JetAPI

๐Ÿค Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Test with demo mode
  5. Submit a pull request

๐Ÿ“„ License

MIT License - see LICENSE for details.

๐Ÿ™ Acknowledgements

โ˜• Support

If you enjoy FlightAbove, consider buying me a coffee:

Buy Me a Coffee


Made with โค๏ธ for aviation enthusiasts worldwide

Star History

Star History Chart

About

FlightAbove transforms your Mac's menu bar into a real-time aviation radar, showing you exactly what aircraft are flying nearby.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 75.0%
  • CSS 19.7%
  • Shell 4.7%
  • HTML 0.6%