skies-adsb

skies-adsb

✈️ Current Version: 2.4.3 🚁

Image of the skies-adsb app running in a browser showing air traffic around KMIA in Miami, FL

Introduction

skies-adsb transforms your browser into a real-time 3D air traffic display. Using ADS-B data from an RTL-SDR receiver, you can explore local air traffic, surrounding airspace, and geography with customizable 3D maps.

Built with:

• JavaScript
• HTML5
• CSS
• Python 3
• WebGL (Three.js)

Runs on all major modern browsers (Chrome, Firefox, Safari).

Features

• Real-time aircraft tracking and rendering using unfiltered ADS-B data

• Deployable on a Raspberry Pi on your local network

• Compatible with existing ADS-B installations on separate hosts

• Enhanced flight data via FlightAware AeroAPI v4

• Aircraft photos and additional information via Planespotters.net

• Custom map layers powered by Natural Earth Data, FAA Aeronautical Data Delivery Service, and OpenStreetMap

• Touch-friendly mobile web interface

• Install as PWA on mobile or desktop

Recording of the skies-adsb app running in a browser demonstrating the use of the onscreen controls

Examples of custom map layers: Miami International (KMIA), LaGuardia (KLGA), and Mexico City International (MMMX) airports

Build and Installation

skies-adsb requires a build process prior to deployment and cannot be run directly from source code.

For complete build and installation instructions, see INSTALL.md.

NOTE: Version 2.x Release

There were breaking changes from 1.x to 2.x. You will need to reinstall the app if you were running the 1.x version.

Please see the CHANGELOG.md for details.

Contributing

Development

For development setup and guidelines, see DEVELOPMENT.md.

Issues

Use the issue tracker to:

• Report bugs
• Request features (Please no requests for Docker containers–see below)
• Suggest improvements

Please include relevant details and steps to reproduce when submitting issues.

Docker

Thank you for your interest in Docker. While I appreciate the interest in Docker containers, my development efforts are currently focused on core functionality. For a Docker container compatible with the SDR Enthusiasts project, check out:

https://github.com/kx1t/docker-skies-adsb

see:

https://github.com/machineinteractive/skies-adsb/issues/6

Community Screenshots

Please share screenshots of your skies-adsb installation in action! To submit a screenshot please open an issue, attach a screenshot, and label it:

screenshot

Support This Project

Thanks

I would like to give special thanks to the following people who gave me valuable feedback and helped me debug the app:

Andre Thais CFI

Frank E. Hernandez

I would also like to thank the authors and creators of the datasets, hardware, libraries, tools, and tutorials used to create this project. None of this would have been possible without their creations.

Attribution

Natural Earth Data

High-quality public domain map datasets are provided by Natural Earth.

OpenStreetMap Data

Additional map data provided by OpenStreetMap via the Overpass API.

Fallback Aircraft Photo

Pan Am Boeing 747-121 N732PA image by Aldo Bidini
Source: Wikimedia Commons

References

Raspberry Pi

Raspberry Pi Documentation

RTL-SDR + ADS-B

The 1090 Megahertz Riddle (second edition) A Guide to Decoding Mode S and ADS-B Signals

RTL-SDR Quick Start Guide

Gqrx is an open source software defined radio receiver

FlightAware PiAware

FlightAware AeroAPI

GIS

PyGIS - Open Source Spatial Programming & Remote Sensing

https://geopandas.org/

Datasets

Natural Earth Data

FAA Aeronautical Data Delivery Service

OpenStreetMap