-
-
Notifications
You must be signed in to change notification settings - Fork 207
Installation
-
Download HyperHDR installer for Windows from HyperHDR github project.
For example:HyperHDR-22.0.0-Windows-AMD64.exe -
Uninstall previous version of HyperHDR (if applied).
-
Run the installer. Windows probably will ask are you sure? It's default behavior for the first time usage for files downloaded from the internet without EV certificate which costs a lot.

-
Then proceed with the installer... just click few times 'next' and 'finish'.
-
Run the HyperHDR from the desktop shortcut.
-
The HyperHDR icon will show up in the right-bottom corner
-
Click it the right button. The menu will show up. Then select 'Settings'. The browser will open HyperHDR www panel.
For the latest versions of Debian and Ubuntu, you can use our APT repository to install or update HyperHDR.
The repository is located at https://awawa-dev.github.io/
For very old Raspberry Pi platforms based on the ARMv6 architecture, like the Raspberry Pi Zero (not to be confused with the Raspberry Pi Zero 2W), the latest installers we build and deliver are for the Debian Bookworm-based version. However, if you're on a newer system, you can build them yourself from source or try installing the Bookworm version.
-
Installing
All HyperHDR SD images since version v19beta2 are linked to the HyperHDR repository so you don't need this step if you use it.
If you have HyperHDR manually installed from Github or are using old SD images before v19beta2, remove HyperHDR first:sudo apt remove hyperhdr
Add HyperHDR repository and install the application:
type -p curl >/dev/null || sudo apt install curl -y curl -fsSL https://awawa-dev.github.io/hyperhdr.public.apt.gpg.key | sudo dd of=/usr/share/keyrings/hyperhdr.public.apt.gpg.key \ && sudo chmod go+r /usr/share/keyrings/hyperhdr.public.apt.gpg.key \ && echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/hyperhdr.public.apt.gpg.key] https://awawa-dev.github.io $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hyperhdr.list > /dev/null \ && sudo apt update \ && sudo apt install hyperhdr -y
-
Upgrade
If you already have a HyperHDR repository set up, you can easily update HyperHDR later:sudo apt update && sudo apt install hyperhdr -y
Warning
Deprecated since the latest Raspberry Pi OS based on Debian Bookworm. It forces the use of the Raspberry Pi Imager tool, which probably improves their collection of statistics or telemetry data. Wifi configuration in wpa_supplicant.conf doesn't work anymore because of Raspberry Pi OS uses now Network Manager (nmcli) with no alternative for head-less configuration currently.
If you create your own user during setup with the Raspberry Pi Imager tool, it will override our default user pi and the HyperHDR service won't start/ In such case reinstall HyperHDR.
Old manual:
-
Assuming you have Raspberry Pi Zero 2 W, RPi 2 (rev. 1.2), 3, 4 5 or newer choose 64bit OS version:
SD-card-image-64bits-aarch64.img.xz -
Download Rufus
-
Insert prepared SD to the reader. Check the reader's letter assigned in Windows.
-
Run Rufus

- Select the img file that you extracted from the downloaded archive.
- Verify that the program selected correct SD card drive's letter
- Click 'Start' to begin the process of writing
-
After the image is written successfully probably you want to configure the Wifi connection for Raspberry Pi.
-
Create file named wpa_supplicant.conf in the boot folder on the SD card and edit its content.
For example (edit your network and password):
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=PL
network={
ssid="Name of your wifi LAN"
psk="Password for your wifi LAN"
}
- Take the SD out of the card reader and put it into the Raspberry Pi.
- It is recommended to reboot the system after first boot because the user (pi) is just created then and the service may be unavailable during that session.
After boot default host name is: HyperHDR
Connect to the www panel using port 8090 (HTTP) or 8092 (HTTPS).
Default user is: pi
Default password is: raspberry
For security reasons, you may consider changing the password for pi user after the first boot.
SSH and SPI are enabled on default.
-
Connect to your Linux OS using SSH client (putty) or using keyboard/monitor. Log in with your default user.
-
First uninstall the previous version of HyperHDR (if applied):
sudo apt remove hyperhdr -
Go to the tmp directory:
cd /tmp -
Download the package from HyperHDR Github release section to the current
tmpdirectory.-
Raspberry Pi OS 32bits choose
armhfsuffix. For example:wget https://github.com/awawa-dev/HyperHDR/releases/download/v22.0.0/HyperHDR-22.0.0-Linux-armhf.deb -
Raspberry Pi OS 64bits choose
arm64suffix. For example:wget https://github.com/awawa-dev/HyperHDR/releases/download/v22.0.0/HyperHDR-22.0.0-Linux-arm64.deb -
Generic x86 Linux: choose
amd64suffix. For example:wget https://github.com/awawa-dev/HyperHDR/releases/download/v22.0.0/HyperHDR-22.0.0-Linux-amd64.deb
-
-
Install the package that you have downloaded from the current directory. For example:
sudo apt install ./HyperHDR-22.0.0-Linux-arm64.deb -
HyperHDR should be up and running on the 8090 (HTTP) or 8092 (HTTPS) port.
-
If the WWW panel is out of reach then run the following command to check what's happening:
/usr/bin/hyperhdr -d -
To start/stop HyperHDR service on Raspberry Pi execute:
sudo systemctl start/stop hyperhdr@pi.service
Since version 16 HyperHDR offers direct support for USB grabbers for macOS (native x64 application, runs on Apple M1 in emulation also) and provides very friendly DMG installation container.
-
Download and run DMG container. Setup installation process will start:
-
After setup is finished you will have mounted volume with HyperHDR application.
-
Drag HyperHDR icon to your applications folder. Next run it.

-
It will take some time (up to one minute) for a first run. HyperHDR icon will be "jumping" in the lower-right corner. Wait until it finishes:
-
After the application starts macOS will ask you about granting camera permission for HyperHDR application. It's required. If you missed the request you can always redo your choice in the macOS' system options. Similar dialog about granting microphone permission shows up when you use the sound effect or system software screen grabber for the first time (the application restart is required here).

-
HyperHDR application is running now. Click HyperHDR icon ('H') in the upper-right corner to bring the menu and then click the settings item. It opens the browser with HyperHDR configuration panel.

-
Now it's time to go through the typical HyperHDR configuration process.

- Getting started. Needed components
- Software installation
- Configurations
- Quick start
- Video source LUT calibration
- P010 high quality video format
- Automatic tone mapping
- Software screen capture
- HyperSerialPico and others
- Hyperk 🆕
- Raspberry Pi 5 GPIO PWM 🆕
- FTDI 🆕
- Audio-reactive lighting effects
- Zigbee2MQTT lights
- Home Assistant lights
- JSON API
- Instance synchronization
- Hue gradient light strips
- Infinite Color Engine 🆕
- RGB to RGBW with dithering (by iCE) 🆕
- Compiling HyperHDR
- FAQ
- 3.3V to 5V level shifter
- Raspberry Pi OS read-only mode