Shaffer-Softworks/hyperhdr-ha v0.1.6

v0.1.6 — Stream API, Admin Password Auth, Entity Cleanup & Codebase Refinements

on GitHub

Highlights

This release introduces WebSocket-based LED camera streaming with admin password authentication, removes deprecated entities, adds automatic stale entity cleanup, and includes numerous stability and UX improvements.

New Features

• WebSocket LED Streaming — LED Colors and LED Gradient cameras now use the new HyperHDRLedColorsStream and HyperHDRLedGradientStream classes from hyperhdr.stream, replacing the old inline WebSocket code with the library's robust streaming layer.
• Admin Password Authentication — Added an optional Admin Password field (available during initial setup and in the Options flow) for authenticating LED camera streams when HyperHDR has Local API Authentication enabled. Stream auth tries token first, then falls back to admin password.
• WebSocket Port Configuration — The Options flow now allows changing the WebSocket port (default 8090) after initial setup.
• Automatic Stale Entity Cleanup — On every integration load, stale entities from removed features are automatically pruned from the entity registry. No manual cleanup required when upgrading.
• Config Entry Migration — Bumped config entry version to 2 with automatic migration. No user action needed.

Improvements

• Camera streaming state — Camera entities now correctly report "streaming" (instead of "idle") when receiving frames.
• Initial state population — All entities (visible priority, average color, switches, smoothing, HDR) now populate their state immediately on load.
• Average color throttling — Average color updates are throttled to 2-second intervals with deduplication to reduce event bus and recorder load.
• Conditional entity creation — Smoothing entities (time, decay, update frequency, type) are only created when the HyperHDR server exposes smoothing data. If the server doesn't support it, these entities are skipped entirely.
• Switch entity names — Removed redundant "Component" prefix from all switch entity names across all 25 translations.
• HDR Tone Mapping — Updated to support both the legacy hdrToneMappingMode and newer videomodehdr command paths.

Removed

• Old JSON-API Camera (HyperHDRCamera) — Replaced by LED Colors and LED Gradient cameras.
• Color Engine Select Entity & hyperhdr.set_color_engine service — Removed (not supported by the connected server).

Dependency Updates

• Bumped hyperhdr-py-sickkick to 0.2.0

Bug Fixes

• Fixed authorization sequence to ensure auth completes before sysinfo calls.
• Fixed LED stream authorization by using admin password auth when tokens lack admin privileges.
• Resolved "unknown" states for Average Color and Visible Priority sensors on startup.
• Cleaned up accidentally committed nested duplicate directories.