The ADS-B Receiver Project

Go to file

Joe Prochazka 6104bc6bb9 Save XML settings from previous installs.		2016-08-19 14:47:29 -04:00
bash	Save XML settings from previous installs.	2016-08-19 14:47:29 -04:00
build	Fixed bad merge.	2016-08-19 14:29:52 -04:00
CHANGELOG.md	Updated CHANGELOG.md	2016-08-18 18:19:15 -04:00
CREDITS.md	Formating fix.	2016-05-10 23:47:12 -04:00
LICENSE.md	…
README.md	Changed install URL.	2016-05-01 18:35:42 -04:00
install.sh	Added warning not to delete directory.	2016-04-22 14:58:55 -04:00

README.md

The ADS-B Receiver Project ✈️

This repository contains a set of scripts and files which can be used to setup an ADS-B receiver on a clean installation of a Debian derived operating system. The scripts are executed in order by the main install script depending on the installation options choosen by the user.

Please note: As of February 2016, the scripts do not work when run on an SD card where the current PiAware image was installed. The scripts require a clean installation of a Debian derived operating system.

The ADS-B Receiver Project website is located at https://www.adsbreceiver.net.

Obtaining And Using This Software

Download the latest ADS-B Receiver Raspbian Jessie Lite image for Raspberry Pi devices. https://github.com/jprochazka/adsb-receiver/releases/latest

When setting up the portal you will have to choose between a lite or advanced installation. Advanced features adds flight logging and plotting and should only be chosen on devices running a more sturdy data storage solution.

It is recommended that anyone using a SD card as they storage medium not attempt to use the advanced features.

Manual installations...

sudo apt-get update
sudo apt-get install git
git clone https://github.com/jprochazka/adsb-receiver.git
cd ~/adsb-receiver
chmod +x install.sh
./install.sh

Updating existing installations...

cd ~/adsb-receiver
git fetch --all
git reset --hard origin/master
./install.sh

Portal setup...

This step pertains to both fresh installations as well as when updating and existing installation. After running the installation scripts you will need to setup the portal by visiting the following web address.

http://<IP_ADDRESS_OF_YOUR_DEVICE>/install/

Supply the infromation asked for and submit the form once done to complete the setup.

What Can Be Installed

At this time the following software can be installed using these scripts.

Decoders

Dump1090 (mutability): https://github.com/mutability/dump1090
Dump978: https://github.com/mutability/dump978

Site Feeders

FlightAware's PiAware: http://flightaware.com
Flightradar24 Feeder Client: http://flightradar24.com
Plane Finder ADS-B Client: https://planefinder.net
ADS-B Exchange: http://adsbexchange.com

ADS-B Receiver Web Portal Features

Saves all flights seen as well as displays a plot for the flight. (advanced)
Control what is displayed online via a web based administration area.
A more uniform website site layout that can be easily navigated.
Web accessible dump1090 and system performance graphs.
A web accessible live dump1090 map.
A web accessible live dump978 map.
A blog which can be used to share your plane tracking experiences with others.
Informs visitors when specific flights are being tracked by dump1090.
Easily customize the look of your portal using the template system.

Supported Operating Systems

The scripts and packages have been tested on most Debian Jessie based operating systems.

The scripts are NOT supported on existing PiAware image based installations. The PiAware image is still based on Raspbian Wheezey version which is missing some required libraries for dump1090-mutability installation.