[Blue sky] On-screen "On Now / On Next" overlay (channel-surf bug) #74

Closed
opened 2026-07-01 23:44:36 +02:00 by timothy · 2 comments
Owner

Concept borrowed from PseudoTV ("On Next" controls). Blue sky / low priority.

Goal

A burned-in "up next" / "on now" bug shown on the stream, for authentic channel-surfing feel (and channel-transition notifications).

Scope

  • Render a small overlay onto the transcoded stream showing current + next program.
  • Configurable per channel / per template.

Notes

  • Requires stream-overlay work in the FFmpeg pipeline (beyond the existing static watermark) — non-trivial.
  • Defer until core redesign is done.

Related: #59.

Done-when

  • Implementation complete — ChannelGraphicsElement join + migration, selector base-layer, seeded on-now-next.yml, channel graphicsElementIds + builtIn, SPA Branding-tab toggle
  • Adversarial whole-branch review passed (verdict MERGEABLE; 5 deferrable Minors, follow-up #568 filed)
  • Docs updated in the same PR (domain-model, channels, decisions + catalog, api-conventions)
  • Live-E2E: write-path verified on a running instance (built-in element seeds builtIn:true; channel PUT graphicsElementIds attach [1] / detach [] round-trips)
  • CI green on the PR (run 1021 — build/test, migrations, functional-E2E, api-docs, format all green)

Post-merge verification (not a merge gate)

  • Visual overlay render confirmed on a content-bearing instance (ersatztv-test, after :latest builds) — the transient NOW/NEXT bug actually burns onto a transcoded stream. The seeded YAML is statically validated (enums/functions/vars all real), but pixels can't be produced on an empty local instance.
Concept borrowed from **PseudoTV** ("On Next" controls). **Blue sky / low priority.** ## Goal A burned-in "up next" / "on now" bug shown on the stream, for authentic channel-surfing feel (and channel-transition notifications). ## Scope - Render a small overlay onto the transcoded stream showing current + next program. - Configurable per channel / per template. ## Notes - Requires stream-overlay work in the FFmpeg pipeline (beyond the existing static watermark) — non-trivial. - Defer until core redesign is done. Related: #59. ## Done-when - [x] Implementation complete — `ChannelGraphicsElement` join + migration, selector base-layer, seeded `on-now-next.yml`, channel `graphicsElementIds` + `builtIn`, SPA Branding-tab toggle - [x] Adversarial whole-branch review passed (verdict MERGEABLE; 5 deferrable Minors, follow-up #568 filed) - [x] Docs updated in the same PR (domain-model, channels, decisions + catalog, api-conventions) - [x] Live-E2E: write-path verified on a running instance (built-in element seeds `builtIn:true`; channel PUT `graphicsElementIds` attach `[1]` / detach `[]` round-trips) - [x] CI green on the PR (run 1021 — build/test, migrations, functional-E2E, api-docs, format all green) ## Post-merge verification (not a merge gate) - Visual overlay render confirmed on a content-bearing instance (ersatztv-test, after `:latest` builds) — the transient NOW/NEXT bug actually burns onto a transcoded stream. The seeded YAML is statically validated (enums/functions/vars all real), but pixels can't be produced on an empty local instance.
timothy added the enhancementpriority: low labels 2026-07-01 23:44:36 +02:00
timothy added the in-progress label 2026-07-22 20:12:39 +02:00
Author
Owner

Claiming — top-ranked eligible backlog winner (scripts/select-queue.sh), and this issue's own deferral condition ("defer until core redesign is done") is now satisfied since the ChicoryTV arc is complete. Scoping/design next; will brainstorm the overlay approach before implementation given it touches the FFmpeg pipeline.

Claiming — top-ranked eligible backlog winner (`scripts/select-queue.sh`), and this issue's own deferral condition ("defer until core redesign is done") is now satisfied since the ChicoryTV arc is complete. Scoping/design next; will brainstorm the overlay approach before implementation given it touches the FFmpeg pipeline.
Author
Owner

Closing record

Outcome: Shipped via PR #569 (merged to main). A per-channel "Show On Now / Next overlay" toggle burns a transient NOW/NEXT EPG text bug onto the transcoded stream at each program change, reusing the existing SkiaSharp graphics engine. New ChannelGraphicsElement join (first channel-level graphics attachment) + dual-provider migration; selector base-layer; seeded built-in on-now-next.yml; channel graphicsElementIds + builtIn REST; SPA Branding-tab toggle.
Root cause: N/A (feature). Recon finding: the rendering + EPG-template-data infrastructure already existed (upstream graphics engine + our #502/#511 work); the only gap was that graphics elements had no channel-level attachment and no seeded built-in element.
Decisions/conventions changed: added graphics.channel-level-attachment (docs/decisions.md + catalog). No supersessions.
Reusable knowledge: Text/EPG overlays require the graphics-element system (watermarks are image-only, one WatermarkId per channel already spent on #67). Graphics elements need a physical YAML file on disk, so the seed materializes a file (marker-gated) and lets the existing RefreshGraphicsElementsHandler own row creation. Overlay content changes per program automatically because the graphics context is rebuilt per playout item; opacity_expression (NCalc LinearFadeDuration) drives the transient fade. EPG at transcode time comes from the cached XMLTV fragment, so accuracy tracks guide-cache freshness.
Decisions/conventions changed (cont.): docs/api-conventions.md, domain-model.md, channels.md updated same PR.
Verification: .NET 182/182, web 25/25 (incl. round-trip test); whole-branch Opus adversarial review = MERGEABLE (0 Critical/Important); write-path live-E2E on a running instance (seed builtIn:true; channel PUT graphicsElementIds attach/detach round-trip); dual-provider migration integrity green; format/BOM/api-docs green. Visual pixel render NOT yet confirmed — needs a content-bearing instance; scheduled for ersatztv-test once :latest builds.
Deferred: (1) Visual overlay render verification on ersatztv-test (post-merge). (2) Follow-up #568 — validate unknown graphicsElementIds → 422 not 500, and harden the builtIn filename discriminator (both Minor, SPA-unreachable).
Docs updated: docs/domain-model.md, docs/channels.md, docs/decisions.md (+ docs/decisions/README.md catalog), docs/api-conventions.md. Design+plan: docs/superpowers/{specs,plans}/2026-07-22-on-now-next-overlay*.

## Closing record **Outcome:** Shipped via PR #569 (merged to `main`). A per-channel "Show On Now / Next overlay" toggle burns a transient NOW/NEXT EPG text bug onto the transcoded stream at each program change, reusing the existing SkiaSharp graphics engine. New `ChannelGraphicsElement` join (first channel-level graphics attachment) + dual-provider migration; selector base-layer; seeded built-in `on-now-next.yml`; channel `graphicsElementIds` + `builtIn` REST; SPA Branding-tab toggle. **Root cause:** N/A (feature). Recon finding: the rendering + EPG-template-data infrastructure already existed (upstream graphics engine + our #502/#511 work); the only gap was that graphics elements had no channel-level attachment and no seeded built-in element. **Decisions/conventions changed:** added `graphics.channel-level-attachment` (docs/decisions.md + catalog). No supersessions. **Reusable knowledge:** Text/EPG overlays require the graphics-element system (watermarks are image-only, one `WatermarkId` per channel already spent on #67). Graphics elements need a physical YAML file on disk, so the seed materializes a file (marker-gated) and lets the existing `RefreshGraphicsElementsHandler` own row creation. Overlay content changes per program automatically because the graphics context is rebuilt per playout item; `opacity_expression` (NCalc `LinearFadeDuration`) drives the transient fade. EPG at transcode time comes from the cached XMLTV fragment, so accuracy tracks guide-cache freshness. **Decisions/conventions changed (cont.):** docs/api-conventions.md, domain-model.md, channels.md updated same PR. **Verification:** .NET 182/182, web 25/25 (incl. round-trip test); whole-branch Opus adversarial review = MERGEABLE (0 Critical/Important); write-path live-E2E on a running instance (seed `builtIn:true`; channel PUT `graphicsElementIds` attach/detach round-trip); dual-provider migration integrity green; format/BOM/api-docs green. **Visual pixel render NOT yet confirmed** — needs a content-bearing instance; scheduled for ersatztv-test once `:latest` builds. **Deferred:** (1) Visual overlay render verification on ersatztv-test (post-merge). (2) Follow-up #568 — validate unknown `graphicsElementIds` → 422 not 500, and harden the `builtIn` filename discriminator (both Minor, SPA-unreachable). **Docs updated:** docs/domain-model.md, docs/channels.md, docs/decisions.md (+ docs/decisions/README.md catalog), docs/api-conventions.md. Design+plan: docs/superpowers/{specs,plans}/2026-07-22-on-now-next-overlay*.
timothy removed the in-progress label 2026-07-22 22:37:21 +02:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: timothy/ersatztv#74