Installation

Prerequisites

Hyperion make use of some external libraries. * The [QT libraries](http://qt-project.org) are used as a basis for the application. * The [protocol buffer](http://code.google.com/p/protobuf) libraries are required for the proto server. * Default set of CA-certificates to allow download from github.

All of these can be installed using the following command:

sudo apt-get update
sudo apt-get install libqtcore4 libqtgui4 libqt4-network libprotobuf7 ca-certificates

In almost all cases is it important, before running the install, to make sure 'boblight' is disabled. Hyperion and boblight most likely use the same device which leads to a conflict if both are on. Boblight can be disabled in the Raspbmc settings menu. To temporarily disable boblight run (boblight will restart on reboot):

sudo initctl stop boblight

Deployment

The installation of hyperion consists of several steps:

1. installation of the hyperiond and hyperion-remote (default installed to '/usr/bin').
2. configuration file for the hyperion daemon (default file '/etc/hyperion.config.json').
3. add hyperiond as a os-service (default hyperion.conf in '/etc/init').
4. start the hyperion service ('initctl start hyperion').

All these steps are wrapped into a single installation script available from the github repository (bin/install_hyperion.sh). This will download and perform the above mentioned steps.

wget -N raw.github.com/tvdzwan/hyperion/master/bin/install_hyperion.sh
sudo sh ./install_hyperion.sh

Note that the installed configuration file may need some changes dependent on your hardware setup. See the configuration page for more information.

Test installation

Test the installation by checking if data can be send to Hyperion. For example try setting all leds to red: ``` hyperion-remote -p 50 -c red ```

Disable Hyperion

The script in /etc/init will start Hyperion on each boot. If you want to disable Hyperion or switch back to Boblight simply stop Hyperion and delete this script: ``` sudo initctl stop hyperion rm /etc/init/hyperion.conf ```