Skip to content

Installation

Warning

The guide has been updated for incoming HyperHDR v22 version.

Windows

  • 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.
    obraz

  • 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.

Debian and Ubuntu (APT repository)

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 2 W), 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.

1) 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

2) Upgrade

If you already have a HyperHDR repository set up, you can easily update HyperHDR later:

sudo apt update && sudo apt install hyperhdr -y

HyperHDR custom Raspberry Pi OS Distribution

Our SD image includes pre-installed HyperHDR with P010 Kernel Fix. The system image is built in the https://github.com/awawa-dev/P010_for_V4L2 repository thanks to Github Action and Raspberry Pi OS base image. We only support the 64-bit architecture, which allows our application to achieve its maximum performance.

  • Download and extract the SD image from HyperHDR Github release repository. 7-zip is recommended.

  • Download Rufus: link. We do not recommend using the Raspberry Pi Imager for this installation, as it may interfere with certain settings, including the HyperHDR startup service.

  • Insert prepared SD to the reader. Check the reader's letter assigned in Windows.

    obraz

    1. Select the img file that you extracted from the downloaded archive
    2. Verify that the program selected correct SD card drive's letter
    3. 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.

  • Debian Trixie expects Wi-Fi configuration to be in a file named wifi.nmconnection located on the SD card (drive named bootfs). Open this file and edit its contents. For example: 

    # Uncomment everything below this line and set your ssid and password
[connection]
id=wifi
uuid=f81d4fae-7dec-11d0-a765-00a0c91e6bf6
type=wifi
interface-name=wlan0

[wifi]
mode=infrastructure
ssid=NAME_OF_YOUR_WIFI

[wifi-security]
auth-alg=open
key-mgmt=wpa-psk
psk=WIFI_PASSWORD

[ipv4]
method=auto

[ipv6]
addr-gen-mode=default
method=auto

[proxy]

  • Take the SD out of the card reader and put it into the Raspberry Pi.

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.

Linux

  • 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 tmp directory.

    • Raspberry Pi OS 32bits choose armhf suffix. 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 arm64 suffix. 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 amd64 suffix. 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

macOS

HyperHDR provides a very user-friendly native DMG installation container for both Intel and arm64 (M1–M4) platforms.

  • Download and mount the DMG container. The setup installation process will start, and you will be prompted to install the application on your system. To do that, drag the HyperHDR icon to your Applications folder.

Screen Shot 2022-08-21 at 6 37 49 PM

  • HyperHDR should then be available in your Finder's Applications folder. Launch it. After the application starts, macOS will ask you to grant camera permission for HyperHDR. This is required. If you missed the request, you can always change your choice later in macOS System Settings. A similar dialog for granting microphone permission will appear when you use the sound effects or the system software screen grabber for the first time (an application restart is required in this case).

  • While HyperHDR is running, it displays an icon ('H') in the upper-right corner. You can use it to open the menu, which contains the 'Settings' option that allows you to open the browser with the HyperHDR configuration panel.

image

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

Screen Shot 2021-09-12 at 3 39 33 PM