Skip to content

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

License

Notifications You must be signed in to change notification settings

machineinteractive/skies-adsb

Repository files navigation

skies-adsb

Screenshot

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

Gif Recording

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

Custom Map Layers

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

a collaborative effort by @kx1t, @tubalainen, and @bbttxu.

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

Attribution

Natural Earth Data

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

Natural Earth Logo

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

About

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

Topics

Resources

License

Stars

Watchers

Forks