Skip to content

v2.1.5 - persistent server-side setup overlay

Choose a tag to compare

View all tags
@rusty4444 rusty4444 released this 09 May 04:33
v2.1.5
08d484b

Highlights

  • Persistent server-side setup overlay (PR #99, closes #98). The in-app setup overlay (gear icon / #setup) is now a real persistent configuration editor: every relevant field — TMDB API key + region, HA token, Plex/Radarr/Sonarr URLs and keys, Coming Soon counts, and visual settings — is editable in the overlay and saves server-side. One save on any device propagates to every browser, kiosk, and phone on the next page load.
  • Settings are saved to /data/overlay.json on the add-on disk via POST /api/setup, so values persist across phone, Master Panel, Fully Kiosk, the HA mobile app via Ingress, and direct URL access without per-device re-entry.
  • Add-on / Docker config (Configuration tab / env vars) remains the defaults; the persistent overlay file overrides them where set. Clearing a non-secret overlay field falls back to the env default.
  • TMDB API key and region are now enterable in the setup overlay itself (closes #97); existing add-on options / Docker env values remain supported as defaults.

Security

  • Secrets are never returned by the server — GET /api/setup only emits *Set booleans, so the overlay can show "(key set)" / "(token set)" markers without ever leaking the value to the browser.
  • Saving a blank secret preserves the existing value so non-secret fields can be edited without re-typing tokens. Only an explicit replacement string overwrites a secret.
  • POST /api/setup/reset deletes the overlay file entirely and reverts every device to the add-on/Docker defaults.

API surface

  • GET /api/setup — non-secret summary plus *Set booleans for the overlay editor.
  • POST /api/setup — persist overlay values; blank secrets preserve existing.
  • POST /api/setup/reset — delete the overlay file (defaults restored).
  • GET /api/config now also surfaces haUrl, haUrlSet, haTokenSet, and landscape so the overlay can prefill non-secret fields consistently across clients.

Changed

  • Setup overlay now POSTs to the server in add-on / Docker mode instead of writing to localStorage only. localStorage is still written as a per-device cache so HACS-only installs (no server) keep working unchanged.

Upgrade

No action required. Existing add-on Configuration / Docker env values continue to work as defaults; saving any field from the overlay on any device now persists server-side and shows up everywhere.

Artifacts

  • Multi-arch HA add-on images on GHCR — pushed by the addon-v2.1.5 tag: ghcr.io/rusty4444/plex-now-showing-{amd64,aarch64,armv7,armhf,i386}:2.1.5 plus :latest.
  • Server changelog: see addons/plex-now-showing/CHANGELOG.md.
Assets 2
Loading