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: https://github.com/hyperion-project/hyperion.ng/pull/1422

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.


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)

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

In Hypercon you will need to enable:

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

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:


Then reboot. In Hypercon you will need to enable:

Last updated