Installation - ntim/hyperion GitHub Wiki

For installation on a RPi running OpenELEC see here.

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. * The libusb libraries are needed for certain devices. * 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 libusb-1.0-0 libprotobuf7 ca-certificates

Note: On XBian I got an error complaining about locale stuff. After running 'sudo dpkg-reconfigure locales' I still got the error, but at least the installation of packages continued. :-S

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 /sbin/initctl stop boblight

Enable spi on XBian

This step is not necessary for Raspbmc which has the spidev enabled by default. On XBian however, Spidev needs to be enabled if you have your leds attached to SPI. If you don't need SPI to work, you can leave this step and remove the modprobe line from /etc/init/hyperion.conf later on.

Remove the spidev from the blacklist by placing a '#' in front of the spi module entry:

xbian@xbian ~ $ sudo nano /etc/modprobe.d/raspi-blacklist.conf
xbian@xbian ~ $ cat /etc/modprobe.d/raspi-blacklist.conf
# blacklist spi and i2c by default (many users don't need them)

#blacklist spi-bcm2708
blacklist i2c-bcm2708
xbian@xbian ~ $

Deployment

The installation of hyperion consists of several steps:

installation of the hyperiond and hyperion-remote (default installed to '/usr/bin').
configuration file for the hyperion daemon (default file '/etc/hyperion.config.json').
add hyperiond as a os-service (default hyperion.conf in '/etc/init').
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 https://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 for 5 seconds: ``` hyperion-remote --priority 50 --color red --duration 5000 ```

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 /sbin/initctl stop hyperion rm /etc/init/hyperion.conf ```