2015-11-04 04:48:08 +00:00
# The ADS-B Feeder Project :airplane:
This repository contains a set of bash scripts and files which can be used to setup an ADS-B
feeder 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.
### Obtaining And Using This Software
2015-12-27 08:58:53 +00:00
#### For new installations...
2015-12-27 08:55:52 +00:00
2015-11-04 04:48:08 +00:00
sudo apt-get install git
2015-12-27 08:55:52 +00:00
cd ~/
2015-11-04 04:48:08 +00:00
git clone https://github.com/jprochazka/adsb-feeder.git
2015-12-27 08:55:52 +00:00
cd ~/adsb-feeder
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
2016-01-20 23:16:12 +00:00
Please refer to the project wiki for more ways to customize your installation.
https://github.com/jprochazka/adsb-feeder/wiki
2015-12-27 08:58:53 +00:00
#### Updating existing installations...
2015-12-27 08:55:52 +00:00
2016-01-28 05:53:32 +00:00
**If updating an installation created before January 28th, 2016...**
Due to the fact the portal was entirly overhauled after the above date you should first backup then delete all files contained in the /var/www/html directory before fetching and running the latest version. Fresh installations and installations created using these files after the above date can disregard the above notice.
2015-12-27 08:55:52 +00:00
cd ~/adsb-feeder
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
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**
* FlightAware's PiAware: http://flightaware.com
2016-01-20 23:14:26 +00:00
* Plane Finder ADS-B Client: https://planefinder.net
2015-12-01 10:57:49 +00:00
* ADS-B Exchange: http://adsbexchange.com
2015-11-04 04:48:08 +00:00
2016-01-26 20:34:42 +00:00
**Web Portal Features**
2015-11-04 04:48:08 +00:00
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.
* Web accessable dump1090 and system performance graphs.
* A web accessable live dump1090 map.
* A web accessable 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.
2015-11-04 04:48:08 +00:00
### Supported Operating Systems
2015-12-21 23:39:26 +00:00
The scripts and packages have been tested on the following operating systems.
2015-11-04 04:48:08 +00:00
2015-12-01 18:23:38 +00:00
- [X] Raspbian Jessie
2015-12-16 16:44:15 +00:00
- [X] Raspbian Jessie Lite
- [X] Debian 8.0 Jessie
2015-12-01 18:23:38 +00:00
- [X] Ubuntu 15.04 Vivid Vervet
- [X] Ubuntu 14.04 LTS Trusty Tahr
2016-01-20 20:37:02 +00:00
2016-01-20 23:14:26 +00:00
### Dump978 Notes
2016-01-20 20:37:02 +00:00
In order to utilize dump978 a second RTL-SDR device is required.
2016-01-20 23:14:26 +00:00
It is important to review the dump978 wiki page before installation.
https://github.com/jprochazka/adsb-feeder/wiki/Configuring-Dump978
