2016-02-16 20:59:36 +00:00
# The ADS-B Receiver Project :airplane:
2015-11-04 04:48:08 +00:00
2016-02-18 15:41:39 +00:00
This repository contains a set of scripts and files which can be used to setup an ADS-B
2016-02-08 21:19:06 +00:00
receiver on a clean installation of a Debian derived operating system. The scripts are executed
2015-11-04 04:48:08 +00:00
in order by the main install script depending on the installation options choosen by the user.
2016-02-21 11:12:35 +00:00
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.
2016-02-16 20:59:36 +00:00
The ADS-B Receiver Project website is located at https://www.adsbreceiver.net.
2016-02-08 21:19:06 +00:00
2015-11-04 04:48:08 +00:00
### Obtaining And Using This Software
2016-02-16 20:59:36 +00:00
Download the latest ADS-B Receiver Raspbian Jessie Lite image for Raspberry Pi devices.
2016-02-18 17:24:52 +00:00
https://github.com/jprochazka/adsb-receiver/releases/latest
2015-12-27 08:55:52 +00:00
2016-04-14 15:26:30 +00:00
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.*
2016-02-16 20:59:36 +00:00
#### Manual installations...
sudo apt-get update
2015-11-04 04:48:08 +00:00
sudo apt-get install git
2016-02-18 17:59:43 +00:00
git clone https://github.com/jprochazka/adsb-receiver.git
2016-02-18 15:41:39 +00:00
cd ~/adsb-receiver
2015-12-01 10:57:49 +00:00
chmod +x install.sh
2015-11-04 04:48:08 +00:00
./install.sh
2015-12-27 08:55:52 +00:00
2015-12-27 08:58:53 +00:00
#### Updating existing installations...
2015-12-27 08:55:52 +00:00
2016-02-16 20:59:36 +00:00
cd ~/adsb-receiver
2015-12-28 19:33:33 +00:00
git fetch --all
git reset --hard origin/master
2015-12-27 08:55:52 +00:00
./install.sh
2016-04-14 15:26:30 +00:00
#### Portal setup...
2016-04-14 15:30:06 +00:00
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.
2016-04-14 15:26:30 +00:00
2016-05-01 22:35:42 +00:00
http://< IP_ADDRESS_OF_YOUR_DEVICE > /install/
2016-04-14 15:26:30 +00:00
Supply the infromation asked for and submit the form once done to complete the setup.
2015-11-04 04:48:08 +00:00
### What Can Be Installed
At this time the following software can be installed using these scripts.
2016-01-20 20:37:02 +00:00
**Decoders**
2015-11-04 04:48:08 +00:00
2016-01-20 20:37:02 +00:00
* Dump1090 (mutability): https://github.com/mutability/dump1090
* Dump978: https://github.com/mutability/dump978
2015-11-04 04:48:08 +00:00
**Site Feeders**
2016-04-15 07:37:05 +00:00
* 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
2015-11-04 04:48:08 +00:00
2016-02-16 20:59:36 +00:00
**ADS-B Receiver Web Portal Features**
2015-11-04 04:48:08 +00:00
2016-04-14 15:30:06 +00:00
* Saves all flights seen as well as displays a plot for the flight. (advanced)
2016-01-26 20:34:42 +00:00
* Control what is displayed online via a web based administration area.
* A more uniform website site layout that can be easily navigated.
2016-02-18 18:58:14 +00:00
* Web accessible dump1090 and system performance graphs.
* A web accessible live dump1090 map.
* A web accessible live dump978 map.
2016-01-28 05:53:32 +00:00
* A blog which can be used to share your plane tracking experiences with others.
2016-02-16 20:59:36 +00:00
* Informs visitors when specific flights are being tracked by dump1090.
* Easily customize the look of your portal using the template system.
2015-11-04 04:48:08 +00:00
### Supported Operating Systems
2016-02-16 20:59:36 +00:00
The scripts and packages have been tested on most Debian Jessie based operating systems.
2016-02-21 11:12:35 +00:00
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.
