From b8929114000bd7353e437bef0a8ff254f5786473 Mon Sep 17 00:00:00 2001 From: Timothy Date: Tue, 21 Jul 2026 21:05:05 +0200 Subject: [PATCH 01/17] docs(60): design spec for in-browser channel preview Verification-oriented HLS preview on the channels list: server-declared per-channel Preview capability (Availability/ManifestUrl/UnavailableReason), a SlideOver panel over the existing HlsPlayer, and an onError extension so playback failures stop being silent. Refs #60 --- ...07-21-in-browser-channel-preview-design.md | 188 ++++++++++++++++++ 1 file changed, 188 insertions(+) create mode 100644 docs/superpowers/specs/2026-07-21-in-browser-channel-preview-design.md diff --git a/docs/superpowers/specs/2026-07-21-in-browser-channel-preview-design.md b/docs/superpowers/specs/2026-07-21-in-browser-channel-preview-design.md new file mode 100644 index 000000000..0ec050c95 --- /dev/null +++ b/docs/superpowers/specs/2026-07-21-in-browser-channel-preview-design.md @@ -0,0 +1,188 @@ +# In-browser channel preview (ersatztv#60) — design + +**Issue:** [#60 — Backlog: browser channel playback after UI redesign](http://192.168.1.95:3000/timothy/ersatztv/issues/60) +**Date:** 2026-07-21 +**Status:** approved, ready for implementation planning + +## Purpose + +Give an operator a way to answer, from inside ChicoryTV, **"does this channel actually work +right now, and is it playing what the guide says?"** — without opening Jellyfin, Kodi, or +Dispatcharr. + +This is a **verification tool**, not a viewing experience. Every design choice below resolves in +favour of diagnostic honesty over watchability: failures are surfaced rather than recovered, and a +green preview is only ever claimed for the pipeline that was actually exercised. + +Explicitly out of scope: channel switching, fullscreen/lean-back UX, resume, a guide-driven +"watch" surface. If a real viewing experience is wanted later it is a separate issue built on this +component. + +## Prior art already in the repo + +Recon established that most of the machinery exists: + +- `hls.js` is already a dependency (`web/package.json`). +- `web/src/media/HlsPlayer.tsx` is a working, reusable, teardown-safe HLS `