HyperHDR

Open source ambient lighting system for television and music setups that analyzes video and audio streams in real time to control lighting with stable,…

  • Home Automation
  • Other
  • Tools & Utilities
Open source ambient lighting system for television and music setups that analyzes video and audio streams in real time to control lighting with stable, high-performance processing on Windows, macOS, and Linux x64 and ARM, including Raspberry Pi.

Platform availability

Available on 3 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm (not listed)
  • Mac
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

83/100 Excellent

Maintained
100last commit 20 days ago
Popular
672,282 GitHub stars
Easy to install
553 install platforms, install notes, Docker image
Light to run
No data
Security check
95no serious findings, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 6 days ago

GitHub stars
2,282
Open issues
35
Last commit
2026-11-01
Latest release
v22.0.0.0
License
MIT
Activity
declining

Checked 18 days ago - source: GitHub (awawa-dev/HyperHDR)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Set a real Zigbee2MQTT password If you are using Zigbee2MQTT lights, edit the Zigbee2MQTT config and replace `CHANGE_THIS_PASSWORD` with your real MQTT password. This is the login for the MQTT message hub, so without the right password the lights will not connect. source
  • Use the correct serial port In the same Zigbee2MQTT config, set `port` to the USB device name for your light controller, for example `/dev/ttyACM0`. If this is wrong, HyperHDR will not be able to find or control the lights. source
  • Start Zigbee2MQTT and open port 8080 Run `cd /opt/zigbee2mqtt` and then `npm start` to start Zigbee2MQTT, and remember its web setup page is on port 8080. If HyperHDR runs on another machine, open that port in your network settings or the page may not be reachable. source
  • Download the latest release Download the latest release for Windows, macOS, or Linux from the project’s GitHub repository and install the package for your operating system. source
  • Desktop install Choose the matching Windows, macOS, or Linux release asset for your architecture from GitHub Releases. source

Fetched 5 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Why won't my Zigbee2MQTT lights connect to HyperHDR?

Set the real MQTT password in the Zigbee2MQTT configuration instead of CHANGE_THIS_PASSWORD, because it is the login for the MQTT message hub. Set port to the USB device name for the light controller, for example /dev/ttyACM0. Open the Zigbee2MQTT web setup port 8080 on the network if the page is not reachable.

Can HyperHDR use video from an HDMI splitter?

HyperHDR can take video via software capture or a split-out video signal. It then calculates light values along the screen edges, including black bars.

Can I drive WS2812B or SK6812 LEDs directly from Raspberry Pi GPIO pins?

No, direct driving of WS2812B or SK6812 LEDs from Raspberry Pi is not officially supported. It can cause many potential and hard-to-diagnose problems, and it does not work at all on RPi5 due to breaking hardware changes.

What system diagnostics does HyperHDR provide?

HyperHDR can show live CPU and RAM usage, CPU temperature, undervoltage detection, USB grabber status, and LED performance.

Answers sourced from github.com, github.com, github.com, www.reddit.com

Community

Collected 53 days ago - public community threads