About

HyperHDR is an open-source ambient lighting system for TVs and music setups, based on real-time video and audio stream analysis. It is designed with a strong focus on stability, high performance, and superior image quality. Optimized for both single-threaded and multi-threaded video processing, HyperHDR runs seamlessly on Windows, macOS (x64/arm64: M1, M2), and Linux x64 & ARM (including Raspberry Pi).

Main Features of HyperHDR

At the heart of HyperHDR lies the Infinite Color Engine, our own in-house rendering pipeline designed for maximum precision and visual fidelity. By leveraging floating-point processing, it produces smoother gradients, eliminates rounding artifacts, and ensures stable, consistent color transformations. While many other solutions rely on basic 24-bit color operations that introduce precision loss and visible banding, the Infinite Color Engine achieves uncompromised accuracy and professional-grade results. With deep-color support for Philips Hue and HD108 devices, HyperHDR provides richer, more vibrant illumination than ever before. ( 🆕 HyperHDR v22)

Key advantages of the Infinite Color Engine:

• Floating-Point Precision: All color computations use high-precision floating-point arithmetic, eliminating cumulative rounding errors for more accurate results
• Linear sRGB Accuracy: Core color transformations are processed in linear sRGB space, ensuring physically correct and consistent light reproduction
• Deep-Color Support: Compatible devices, including Philips Hue lamps and HD108 LEDs, can take advantage of rendering beyond standard 24-bit RGB color depth.
• Advanced color smoothing algorithms: inertia-based physics, exponential, and perceptually-uniform YUV/RGB interpolators for more fluid and natural color transitions

Additional features:

• Ultra-low CPU usage on SoCs like Raspberry Pi or Intel N100
• Lightweight design with no heavy dependencies (e.g., Python, Java)
• Low-latency video processing for LED strips and lamps
• Optimized multithreading, enabling Raspberry Pi to process high-quality video streams
• High portability across ARM-based embedded platforms
• System diagnostics: live CPU/RAM usage, CPU temperature, undervoltage detection, USB grabber and LED performance
• USB grabber support for Linux, Windows 10/11, and macOS for P010/NV12/YUYV/MJPEG/UYVY/I420/RGB
• Hardware-accelerated capture: PipeWire/Portal (Linux/Wayland), DirectX (Windows 10/11)
• HDR-ready DirectX screen grabbing: Supports DXGI_FORMAT_R16G16B16A16_FLOAT and multiple monitors
• Optimized video processing: Our optimized pipeline handles smoothly 1080p P010/NV12/YUYV even on Rpi4
• Built-in audio visualization powered by spectrum analysis
• MQTT support for IoT integration
• Home Assistant and zigbee2mqtt integration
• Automatic tone mapping for SDR/HDR content
• Automatic LUT calibration for optimal HDR/SDR grabber quality using MP4 test files
• Latency benchmarking for USB grabbers
• P010 support for Windows, Linux: our patched Raspberry Pi OS image (P010 is unsupported in mainline OS)
• Intuitive LED strip editor, with automatic or manual geometry editing via mouse and context menus
• Smart signal detection with adaptive learning for USB grabbers
• Advanced SK6812 RGBW calibration for HyperSerialEsp8266, HyperSerialESP32, HyperSPI, and HyperSerialPico
• External tone mapping support for flatbuffers/protobuf sources
• Wide LED strip compatibility and for WS281x, APA102, HD107, SK9822, SK6812 our ultra-fast LED controllers:
  • HyperSPI for ESP8266/ESP32/rp2040
  • HyperSerialEsp8266, HyperSerialESP32, HyperSerialPico USB serial port 2Mb+ speed connection
  • HyperSerialWLED: our optimized WLED fork with USB serial port 2Mb+ speed connection

HyperHDR’s advanced video pipeline significantly enhances LED output, creating a smoother, more immersive ambient lighting experience. It works with SDR, HDR, and Dolby Vision (LLDV if supported by your hardware). Instead of relying on USB grabbers, you can also use software screen capture directly from your PC.

Downloads

Official releases:
https://github.com/awawa-dev/HyperHDR/releases

Official Linux repository:
https://awawa-dev.github.io/

Latest test builds (GitHub login required):
https://github.com/awawa-dev/HyperHDR/actions

Manuals & Guides

Installation manual
Official Wiki
Complete guide to building an SK6812 RGBW ambient lighting system (2023)

Community

HyperHDR Support Forum

Building from Source

Compilation guide

In the Press

Make: Magazine #84 (2023)
MagPi #117 (2022)
Comparison of modern ambient lighting systems (2023)
Tutorial on raspberrypi.com
Building a 4K HDMI TV Backlight (2021)

License

Released under the MIT License