Skyterm

ADS-B Flight tracker using FlightAware
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Roadmap
4. Contributing
5. License

About The Project

SkyTerm is a React-based web application designed for real-time flight tracking using ADS-B (Automatic Dependent Surveillance-Broadcast) data. It leverages Supabase Realtime to stream live updates directly from an ADS-B device connected to a Raspberry Pi. I actually got the hardware for tracking flights several years ago, but didn't particularly like the provided map interface, so I made my own!

(back to top)

Built With

• 
• 

(back to top)

Getting Started

In order to get live data into the dashboard, you will need to configure the Skyterm Agent. See the project page for more information about required hardware and setup.

Prerequisites

• Supabase Instance
  • If you plan on deploying to production, will need to create a paid account. If you just want to run locally, you can use the CLI to start a local stack: Local Dev
• Skyterm Agent

Installation

1. Clone the repo

   git clone https://github.com/zjpiazza/skyterm.git

2. Install NPM packages

   npm install

3. Enter the Supabase environment variables

   VITE_SUPABASE_URL = ""
   VITE_SUPABASE_ANON_KEY = ""

4. Run the project

   npm dev

(back to top)

Roadmap

• Collect and Analyze Analytics of Flights Over Time
  • Implement data logging for flight paths, altitudes, speeds, and timestamps.
  • Develop a basic dashboard to visualize trends (e.g., busiest times, common routes).
  • Enable export of analytics data as CSV for user analysis.
• Real-Time Alerts and Notifications
  • Add custom alerts for specific flights or airports (e.g., delays, takeoffs).
  • Implement emergency squawk code detection (7500, 7600, 7700) with push notifications.
• Enhanced Filtering Options
  • Allow users to filter flights by altitude, speed, aircraft type, or airline.
  • Add a search feature for squawk codes to quickly identify specific aircraft.

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the project_license.

See LICENSE.txt for more information.

(back to top)