# Hyperion

<mark style="color:red;">WARNING: Hyperion does not support the GBM/V4L2 video pipeline used in LibreELEC 10.x and 11.x: including all Raspberry Pi and Generic x86\_64 (GBM) releases. Users with x86\_64 hardware can update to the Generic\_Legacy (X11) image. Users with Raspberry Pi hardware must use an external grabber hardware device or remain on older releases. Changes to add GBM support to Hyperion are tracked here:</mark> <https://github.com/hyperion-project/hyperion.ng/pull/1422>

[Hyperion](https://github.com/hyperion-project/hyperion) is an open source project that provides an ambient lighting system, compatible with Kodi. Hyperion requires hardware and software configuration. This page describes the process to add Hyperion to Generic x86\_64 and Raspberry Pi hardware. For software configuration please head over to [Hypercon](https://wiki.libreelec.tv/configuration/hypercon).

## Adalight

If you want hardware that will work on any LibreELEC device, an "Adalight" setup is the best choice. It works by sending serial data to an Arduino micro controller which controls the LEDs. You need:

* Arduino (Uno, nano, etc)
* WS2801 LED strand
* 5V power supply
* Wire/Jumpers
* Breadboard/Protoboard (optional)
* Soldering iron (optional)

![Adalight wiring](https://2659664661-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MAdvk5nyUZ57Kqgd94Z%2Fuploads%2Fgit-blob-4b7e571d72964e7188e1507e9183fed9eba7bf96%2Fhyperion-adalight.png?alt=media)

Follow the tutorial here <https://learn.adafruit.com/adalight-diy-ambient-tv-lighting/overview>.

In [Hypercon](https://wiki.libreelec.tv/configuration/hypercon) you will need to enable:

![Hypercon configuration Adalight](https://2659664661-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MAdvk5nyUZ57Kqgd94Z%2Fsync%2F74ff686a0a85c38eace91055b61d983eab3128a2.png?generation=1605099737523537\&alt=media)

## Raspberry Pi

Pi devices can drive an SPI output directly, and hyperion can output to an spidev device. You need:

* Raspberry Pi
* WS2801 LED strand
* 5V power supply
* Wire/Jumpers

![Raspberry Pi wiring](https://2659664661-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MAdvk5nyUZ57Kqgd94Z%2Fsync%2Fd91d5ecff128c0fa1dde22fe264bacfe6809eeb3.png?generation=1605099234359979\&alt=media)

You can find the pinout here <https://pinout.xyz>. You will need to connect the following pins:

```
19 MOSI -> Data
23 SCLK -> Clock
25 GND  -> Ground
```

You need to enable SPI in the config.txt file:

```
mount -o remount,rw /flash
nano /flash/config.txt
```

Add the following line to the end of the file:

```
dtparam=spi=on
```

Then reboot. In [Hypercon](https://wiki.libreelec.tv/configuration/hypercon) you will need to enable:

![Hypercon configuration Raspberry Pi](https://2659664661-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MAdvk5nyUZ57Kqgd94Z%2Fuploads%2Fgit-blob-73912876e3912900c358a904516bf848af8b1df0%2Fhyperion-config-rpi.png?alt=media)