haos-hacs-integration-media-player/RELEASE_NOTES.md

v0.3.1 (2026-05-18)

Features

• Foreground process sensors — new "Foreground" device (linked to the hub via via_device) exposing what's currently in focus on the remote PC:
  • sensor.foreground_process — process name as state, with full payload (PID, exec path, window title, fullscreen flag, monitor, geometry, browser detection, browser page title/URL, error) as attributes
  • sensor.window_title, sensor.pid, sensor.foreground_monitor, sensor.process_started (TIMESTAMP device class)
  • binary_sensor.fullscreen, binary_sensor.minimized
  • Fed by a new ForegroundCoordinator polling GET /api/foreground every 5s, with near-real-time updates via the existing WebSocket (foreground / foreground_update push frames flow into the coordinator) (9d27727)
• Optional API token — CONF_TOKEN is now optional. When the media server runs without api_tokens configured (auth disabled), the integration omits the Authorization header and ?token= query from REST, WebSocket, and album-art URLs. Server-side auth rejections still surface as invalid_auth in the UI (ab05852)

Performance

• Shared DisplayCoordinator — a single /api/display/monitors poll per cycle is now fanned out to all per-display entities (binary sensors, numbers, selects, sensors, switches) via CoordinatorEntity. Removes ~9x redundant requests per polling cycle that previously came from each entity calling get_display_monitors() in its own async_update (ab05852)
• Optimistic write-through — coordinator.apply_optimistic(...) keeps sibling entities in sync after slider/select writes without an extra network round-trip (ab05852)

UI / Localization

• Display entities migrated to Home Assistant translation keys (strings.json / translations/*), so per-language UI text flows through the standard locale mechanism instead of hardcoded English strings (9d27727)

---

All Commits

Hash	Message	Author
9d27727	feat(foreground): foreground process sensors + translation key migration	alexei.dolgolyov
ab05852	feat: shared DisplayCoordinator + optional API token	alexei.dolgolyov