← Directory

HyperHDR

Open source ambient lighting implementation for television and music sets based on the video and audio streams analysis.

  • Home Automation
  • Other
  • Tools & Utilities
Open source ambient lighting implementation for television and music sets based on the video and audio streams analysis. Focused on stability while ensuring performance and quality. Single and multi-threaded video processing optimization for Windows, macOS and Linux x64 & ARM (Raspberry Pi and others).

Platform availability

Available on 2 of 6 install platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm (not listed)

Also on Docker Hub

Health score

77/100 Good

Maintained
100last commit 5 days ago
Popular
672,176 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

How is this calculated?

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). Factors without data are left out and the rest are rescaled.

Availability: platform listings confirmed today

GitHub stars
2,176
Open issues
34
Last commit
2026-10-04
Latest release
v22.0.0.0
License
MIT
Activity
rising

Checked today - source: GitHub (awawa-dev/HyperHDR)

Resources & Compatibility

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

Checked 10 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

Fetched 10 days ago - each note links to its source

Alternatives (12)

  • Bear - Flexible writing and note-taking tool with markdown, plain text storage, cross-note links, hashtags, powerful search, Focus Mode, iCloud sy…
  • CherryTree - Free, open-source note-taking with rich text, cross-platform support, syntax highlighting, embedded files, and customizable interface.
  • Foam - Foam is a personal knowledge management and sharing system inspired by Roam Research, built on Visual Studio Code and GitHub.
  • HelixNotes - HelixNotes is a local markdown note-taking app built with Rust, Tauri 2.0, and SvelteKit.
  • MarkText - Markdown editor for Mac, Windows, and Linux with real-time preview and distraction-free interface.
  • Nuclino - Nuclino is a digital workspace that acts as a "collective brain" for your team.
  • QOwnNotes - Plain text notepad with markdown support and todo list manager for Linux, Mac OS X and Windows, that works together with the notes applicat…
  • Todoist - Manages tasks across all platforms with advanced language recognition.
  • Trilium Notes - Trilium Notes is a free and open-source, cross-platform hierarchical note taking application with focus on building large personal knowledg…
  • Turtl - Whether it's bookmarks or passwords, files or shopping lists...Turtl organizes it all and makes it easy to find later.
  • Zettlr - Comprehensive writing tool for notes, citations, and drafting with privacy-first features and multi-language support, perfect for diverse w…
  • Zim - Zim brings the concept of a wiki to your desktop.

Checked 8 days ago - source: AlternativeTo

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 9 days ago - public community threads