Jump to Step: The Pi | First Boot | SSH | Install | Configure | Colors | Advanced

Hyperion(-NG) vs HyperHDR

You might be asking, why HyperHDR instead of Hyperion or Hyperion-NG?

Personally I find HyperHDR to be more stable; in addition, HyperHDR makes using the Pi's GPIO pins directly much simpler. We do NOT necessarily need the HDR functionality - I just prefer this particular Hyperion fork...

If you choose to instead use a different fork, such as -NG, my instructions will not work. You will need to install additional software (and hardware!) in order to make this work with the Hyperion-NG project. So...
Update: October 29, 2026 HyperHDR 22.0.0.0 has been released. This tutorial reflects the new update, and other than the changes to the link, the process remains exactly the same!

If you already have HyperHDR 19, 20, or 21 installed, and wish to update, you can do so within the HyperHDR interface, right there on the first page you'll see an option to upgrade with a single click.

Install HyperHDR

First we need to install HyperHDR. You should be looking at a command prompt, that should look something like this:
your_username@raspberrypi:~ $ 
Copy & Paste
Throughout this tutorial, anywhere you see this:
📋 COPY - then PASTE, then press ENTER
This means that after clicking 📋 COPY, you will go over to PuTTy (ALT+TAB), RIGHT-click in the PuTTy window to Paste, and then press ENTER.

Some of the commands can be very long lines, but using the 📋 COPY shortcut reduces errors and makes it much faster. Linux commands are Case Sensitive and must be typed EXACTLY as shown. I encourage you to utilize the Copy & Paste options provided.

So let's get started!

By default, the Pi OS is set up so that you can use sudo without a password. sudo runs code as root, and should ONLY be used when necessary.

Since we are installing software, we need to do so as root. So let's start with the following command to ensure our software catalog is up-to-date:

sudo apt update
📋 COPY - then PASTE, then press ENTER

This may take a few moments, and may ask for confirmations; simply type 'y' and press Enter.

OPTIONAL: To make sure all packages are up-to-date, use the following command.

sudo apt -y upgrade
📋 COPY - then PASTE, then press ENTER

The upgrade command may take a while to complete as well; simply let it finish. The -y flag tells it to assume YES to any questions, so it will continue running until it is finished.

Rapsberry Pi 5:
I don't actually recommend using a Pi 5 for this project, as it is serious overkill. But if it is what you have, you cannot use the GPIO pins, and instead will have to use SPI. You will connect your Green and White wires to the SPI pins instead (outlined in the insert that comes with the level shifter).

This method also works on the other Pi boards, but is only recommended if you cannot get the preferred GPIO method to work. If you are using GPIO, Skip the next two commands.

sudo raspi-config nonint do_spi 0
📋 COPY - then PASTE, then press ENTER

Next we'll increase the SPI buffer:

sudo sh -c "echo -n ' spidev.bufsize=1048576' >>/boot/firmware/cmdline.txt"
📋 COPY - then PASTE, then press ENTER

Installing HyperHDR:
To download HyperHDR 22.0.0.0, simply paste the following.

Note that the 32-Bit Pi Zero is not recommended as it can barely handle the load of HyperHDR; I have since removed the links for the 32-Bit version to avoid confusion.

Download HyperHDR:
wget https://github.com/awawa-dev/HyperHDR/releases/download/v22.0.0.0/HyperHDR-22.0.0-Linux-aarch64.deb
📋 COPY - then PASTE, then press ENTER

This will download HyperHDR 22.0.0.0. Now let's install it:

Install HyperHDR:
sudo apt -y install ./HyperHDR-22.0.0-Linux-aarch64.deb
📋 COPY - then PASTE, then press ENTER

After a minute or so, it should complete.

Run HyperHDR as Root

The installer automaticaly started HyperHDR as your current user - we need to disable that version first. This command will do that:

sudo systemctl disable --now hyperhdr@$USER
📋 COPY - then PASTE, then press ENTER

Now we need to enable HyperHDR, but have it run as the 'root' user so that it can access the GPIO pins:

sudo systemctl enable --now hyperhdr@root
📋 COPY - then PASTE, then press ENTER

Now HyperHDR is running as 'root' and will start automatically with the Pi.

Restart & Install

To make all of these changes take effect, and to ensure any updates that were installed during the earlier steps get applied, let's restart the Pi OS:

sudo reboot
📋 COPY - then PASTE, then press ENTER

PuTTY will immediately disconnect; simply click OK -- but don't close the PuTTy window just yet; we'll come back to it a bit later.

In either case it will take a couple minutes for the Pi to boot back up.

Configure HyperHDR

At this point, I recommend using a Laptop, Tablet or Phone (Laptop preferred) so that you can be in the same room as the Television.

Open a browser, and type the following into the Address bar (NOT the Search Box!) using your Pi's hostname or IP address:
http://hostname.local:8090
Or:
http://192.168.0.XXX:8090
The :8090 is required, as this specifies the Port that HyperHDR runs on. DO NOT type https -- this is not a "Secure Server". Once loaded, you may want to go ahead and bookmark that page in your browser for future configuration.

When prompted, click Change Password and choose a password you'll remember. Don't alter the Username in this dialog, simply leave it as 'hyperhdr'. Alternatively, you can click on "Do Not Prompt Again" and simply access this configuration without a password.

Now, if you followed the ▶ YouTube Video and installed the hardware in the manner I showed, the next step will walk you through configuring your hardware setup.

▶ Next: Configre HyperHDR

◀ Prev: Log Into the Pi

↩ Back to the Beginning

.

Valid CSS!

Buy Me A Coffee

Home | About Me | More Info

Privacy Policy