---
title: "HyperHDR"
description: "HyperHDR is a Marketplace integration for Home Assistant. It has 570 installs sharing analytics, works locally and was last updated September 30, 2026."
canonical: "https://vulpo.app/integrations/marketplace/shaffer-softworks-hyperhdr-ha"
url: "https://vulpo.app/integrations/marketplace/shaffer-softworks-hyperhdr-ha.md"
last-updated: "2026-10-22"
version: "1.4"
---

# HyperHDR

> HyperHDR is a Marketplace integration for Home Assistant. It has 570 installs sharing analytics, works locally and was last updated September 30, 2026.

HyperHDR is a local integration that connects Home Assistant to a HyperHDR bias lighting instance. It adds a main light and a priority light, plus a button that clears the active priority. Cameras show the LED colors as a live stream and as a per-LED gradient image, and a sensor reports the average color. Number and select entities adjust smoothing and HDR tone mapping, and switches toggle components, blackbar detection, the anti-flicker filter and continuous output. Further sensors report system details such as version, hostname and CPU information. Home Assistant can discover instances on the network, and setup is done in the UI with a new or existing token and an optional admin password.

Automatic summary of the README and code of Shaffer-Softworks/hyperhdr-ha. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact)

[Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=Shaffer-Softworks&repository=hyperhdr-ha&category=integration)

On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=Shaffer-Softworks&repository=hyperhdr-ha&category=integration)

## Supports

- **Works locally**: Talks to your devices on your own network. No vendor cloud in between.
- **Found by itself**: Home Assistant spots it on the network and offers to add it.
- **From the Marketplace**: Installed through the Marketplace, formerly HACS.
- **Actively maintained**: Its author released or pushed a change in the last six months.

## Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

### Connect

- **Host**
- **JSON API Port**
- **WebSocket Port (for LED streaming)**
- **Admin Password (optional, for stream auth and smoothing config)**

### Sign in

- **Automatically create new token**
- **Or provide pre-existing token**

### After setup

- **HyperHDR effects to show**
- **Host**
- **JSON API Port**
- **HyperHDR priority to use for colors and effects**
- **Clear priority when main light turns off**
- **Keep WLED in realtime mode when off (idle black)**
- **WebSocket Port (for LED streaming)**
- **Admin Password (for LED streams and smoothing config)**

Texts from the code of [Shaffer-Softworks/hyperhdr-ha](https://github.com/Shaffer-Softworks/hyperhdr-ha).

## Entities

- **Buttons**: Clear Priority
- **Lights**: Light, Priority Light
- **Numbers**: Smoothing Time, Smoothing Update Frequency, Smoothing Factor, Smoothing Stiffness, Smoothing Damping, Smoothing Y Limit, HDR Tone Mapping
- **Selects**: Smoothing Type
- **Sensors**: Visible Priority, Average Color, Build, Version, CPU Hardware, CPU Model Name, CPU Model Type, CPU Revision, Kernel Type, Hostname, Platform, Architecture, and 2 more
- **Switches**: All, Smoothing, Blackbar Detection, Forwarder, Boblight Server, Platform Capture, LED Device, USB Capture, HDR Tone Mapping, Anti-flicker Filter, Continuous Output

## From the README

> HyperHDR is an open source bias lighting implementation which runs on many platforms.
>
> This component will set up the following platforms.
>
> - LED Colors Camera: Live WebSocket stream of the HyperHDR imagestream output — ideal for PicCap instances or visualizing exact LED output.
> - LED Gradient Camera: Real-time per-LED gradient visualization rendered as a JPEG image from raw RGB data.
> - Average Color Sensor: Average RGB as hex with attributes, from current-state/average-color RPC (with LED stream and priority-color fallbacks).
> - HDR Tone Mapping: Adjust HDR tone mapping intensity with a dedicated number entity. Supports both legacy hdrToneMappingMode and the newer videomodehdr command paths.
> - Smoothing Controls (conditional): Number and select entities for HyperHDR v22 smoothing config (time\_ms, update frequency, factor, stiffness, damping, Y limit, interpolator type) — created when…
> - Anti-flicker / Continuous Output (conditional): Config switches for antiFlickeringFilter and continuousOutput.
> - Component Switches: Enable/disable HyperHDR components (advanced users).
> - Automatic Entity Cleanup: Stale entities from removed features (old camera, color engine, decay, unsupported smoothing) are automatically pruned from the entity registry on integration load.
> - SSDP Auto-Discovery: HyperHDR instances on your network are automatically discovered via SSDP/UPnP — no manual IP entry required.

From the README of [Shaffer-Softworks/hyperhdr-ha](https://github.com/Shaffer-Softworks/hyperhdr-ha#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened.

## At a glance

- Kind: Marketplace integration
- Category: [Lighting](https://vulpo.app/integrations/category/lighting.md), LED strips and controllers
- Number: 570 installs sharing analytics; 100 GitHub stars
- Connection: Works locally
- Upkeep: Updated in the last 6 months
- Needs: Needs the Marketplace (HACS on 2026.10 and older)
- Latest version: v1.2.1, last updated September 30, 2026
- Domain: `hyperhdr`
- Source: <https://github.com/Shaffer-Softworks/hyperhdr-ha>
- Issues: <https://github.com/Shaffer-Softworks/hyperhdr-ha/issues>
- Screenshot: https://vulpo.app/integrations-img/2a4d6c28db9ed345.webp (from Shaffer-Softworks/hyperhdr-ha's README)
- Screenshot: https://vulpo.app/integrations-img/f7ddc2d80820e4ce.webp (from Shaffer-Softworks/hyperhdr-ha's README)
- Screenshot: https://vulpo.app/integrations-img/af0ab6756b79d52c.webp (from Shaffer-Softworks/hyperhdr-ha's README)

In Vulpo: Light card, Quick Toggle card, Camera card, Button card, Apple Watch, Control Center

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about)

Last updated 2026-10-22. Source: https://vulpo.app/integrations/marketplace/shaffer-softworks-hyperhdr-ha

---

- HTML version of this page: https://vulpo.app/integrations/marketplace/shaffer-softworks-hyperhdr-ha
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml
