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
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
RTL-SDR + ADS-B
The 1090 Megahertz Riddle (second edition) A Guide to Decoding Mode S and ADS-B Signals
Gqrx is an open source software defined radio receiver
GIS
PyGIS - Open Source Spatial Programming & Remote Sensing
