Skip to content
Branch: master
Find file Copy path
Find file Copy path
13 contributors

Users who have contributed to this file

@redPanther @brindosch @Paulchen-Panther @bajiomeke @Starbix @WoLpH @tpmodding @IIIdefconIII @RickDB @penfold42 @nils1603 @rudelm @XfableX
181 lines (136 sloc) 5.27 KB

With Docker

If you are using Docker, you can compile Hyperion inside a docker container. This keeps your system clean and with a simple script it's easy to use. Supported is also cross compiling for Raspberry Pi (Debian Stretch or higher). To compile Hyperion just execute one of the following commands.

The compiled binaries and packages will be available at the deploy folder next to the script.
Note: call the script with ./ -h for more options

Native compiling on Raspberry Pi

Raspbian Stretch

wget -qN && chmod +x *.sh && ./ -t rpi-raspbian-stretch

Raspbian Buster

wget -qN && chmod +x *.sh && ./ -t rpi-raspbian-buster

Cross compiling on X64_86 for:


wget -qN && chmod +x *.sh && ./


wget -qN && chmod +x *.sh && ./ -t i386

Raspberry Pi v1 & ZERO

wget -qN && chmod +x *.sh && ./ -t armv6hf

Raspberry Pi 2 & 3

wget -qN && chmod +x *.sh && ./ -t armv7hf

The usual way


sudo apt-get update
sudo apt-get install git cmake build-essential qtbase5-dev libqt5serialport5-dev libusb-1.0-0-dev python3-dev libxrender-dev libavahi-core-dev libavahi-compat-libdnssd-dev libjpeg-dev libqt5sql5-sqlite

on RPI you need the videocore IV headers

sudo apt-get install libraspberrypi-dev

OSMC on Raspberry Pi

sudo apt-get install rbp-userland-dev-osmc

ATTENTION Win10LinuxSubsystem we do not (/we can't) support using hyperion in linux subsystem of MS Windows 10, albeit some users tested it with success. Keep in mind to disable all linux specific led and grabber hardware via cmake. Because we use QT as framework in hyperion, serialport leds and network driven devices could work.


See AUR for PKGBUILDs on arch. If the PKGBUILD does not work ask questions there please.


To install on OS X you either need Homebrew or Macport but Homebrew is the recommended way to install the packages. To use Homebrew XCode is required as well, use brew doctor to check your install.

First you need to install the dependencies:

brew install qt5
brew install python3
brew install cmake
brew install libusb
brew install doxygen

Compiling and installing Hyperion

The general quick way (without big comments)

complete automated process:

wget -qO- | sh

some more detailed way: (or more or less the content of the script above) be sure you fulfill the prerequisites above.

git clone --recursive hyperion
cd hyperion
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j $(nproc)
if this get stucked and dmseg says out of memory try:
make -j 2
# optional: install into your system
sudo make install/strip
# to uninstall (not very well tested, please keep that in mind)
sudo make uninstall
# ... or run it from compile directory
# webui is located on localhost:8090 or 8091


Creates hyperion directory and checkout the code from github

export HYPERION_DIR="hyperion"
git clone --recursive --depth 1 "$HYPERION_DIR"


Change into hyperion folder and create a build folder

mkdir build
cd build

Generate the make files:

To generate make files with automatic platform detection and default settings:

This should fit to RPI, x86, amlogic/wetek

cmake -DCMAKE_BUILD_TYPE=Release ..

Developers on x86 linux should use:

cmake -DPLATFORM=x11-dev -DCMAKE_BUILD_TYPE=Release ..

To use framebuffer instead of dispmanx (for example on the cubox-i):


To generate make files on OS X:

Platform should be auto detected and refer to osx, you can also force osx:

cmake -DPLATFORM=osx -DCMAKE_BUILD_TYPE=Release ..

Run make to build Hyperion

The -j $(nproc) specifies the amount of CPU cores to use.

make -j $(nproc)

On a mac you can use sysctl -n hw.ncpu to get the number of available CPU cores to use.

make -j $(sysctl -n hw.ncpu)

Install hyperion into your system

Copy all necessary files to /usr/local/share/hyperion

sudo make install/strip

If you want to install into another location call this before installing

cmake -DCMAKE_INSTALL_PREFIX=/home/pi/apps ..

This will install to /home/pi/apps/share/hyperion

Integrating hyperion into your system

... ToDo

You can’t perform that action at this time.