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,…
Platform availability
Available on 3 of 10 platforms
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
Variants
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
- My HyperHdr setup. : r/WLED - Reddit (reddit)
- Hyperion / HyperHDR question : r/homeassistant - Reddit (reddit)
- Just wanted to share my HyperHDR setup. : r/smarthome - Reddit (reddit)
- Losing my sanity getting HDR to work on HyperHDR - Reddit (reddit)
- Very happy with my first HyperHDR project! : r/raspberry_pi - Reddit (reddit)
- After a month of trial and error, I finally got HA + HyperHDR - Reddit (reddit)
Collected 53 days ago - public community threads