Home - ntim/hyperion GitHub Wiki

Introduction
Command line utility
Android remote
Web app
XBMC addon (not for RPi)
Hardware
Installation
Configuration
Effect development
Software architecture
License

Hyperion is an opensource 'AmbiLight' implementation controlled using the RaspBerry Pi running [Raspbmc](http://www.raspbmc.com). The main features of Hyperion are: * Low CPU load. For a led string of 50 leds the CPU usage will typically be below 2% on a non-overclocked Pi. * Json interface which allows easy integration into scripts. * A command line utility allows easy testing and configuration of the color transforms (Transformation settings are not preserved over a restart at the moment...). * Priority channels are not coupled to a specific led data provider which means that a provider can post led data and leave without the need to maintain a connection to Hyperion. This is ideal for a remote application (like our Android app). * HyperCon. A tool which helps generate a Hyperion configuration file. The tool will also remember your settings from the previous run. * Android remote control to set a static color. * XBMC-checker which checks the playing and screensaver status of XBMC and decides whether or not to capture the screen. The checker also detects whether XBMC is playing 3D video content. * Black border detector. * A scriptable effect engine. * Boblight server interface to enable the use of clients written for Boblight. * Generic software architecture to support new devices and new algorithms easily.

Raspbmc forum topic: http://forum.stmlabs.com/showthread.php?tid=11053

At this moment multiple types of led devices are supported. Other devices may be added, but we are unable to test those and therefore we need help with this. If you want support for an additional device pleas let us know and maybe we can add the new device with your testing (or even coding) help. Hyperion is not the only 'Ambilight' clone available for the Raspberry Pi. [Boblight](https://code.google.com/p/boblight/) is a well known and much more used alternative. Why choose Hyperion? Hyperion is built with the Raspberry Pi's limited amount of processing power in mind resulting in an implementation which is about **15x** faster. Where Boblight is setup as a client-server, Hyperion is built in a single app. This drops the need to serialize and deserialize all data sent between the video grabber and the led controller. Hyperion has the possibility to enable an interface which accepts data from clients written for Boblight. This makes it easier to switch to Hyperion if other devices for which no Hyperion client exist are still used. Note that all color transformations should be disabled in the Boblight client, because otherwise transformations are applied twice (first by the Boblight client and second by Hyperion). Boblight has a default gamma correction value of 2.2 which needs to be set to 1. Below is an example of how to run boblight-X11 when connecting to Hyperion. ``` DISPLAY=:0.0 /usr/local/bin/boblight-X11 -s 192.168.53.21:19333 -o gamma=1 -x ```