Auto-tuning: generate channels automatically from library metadata #69
Closed
opened 2026-07-01 23:44:02 +02:00 by timothy
·
6 comments
No Branch/Tag Specified
main
renovate/dotnet-monorepo
renovate/meziantou.analyzer-3.x
renovate/lucene.net
renovate/sqlitepclraw.bundle_e_sqlite3-3.x
renovate/cliwrap-3.x
913-scripted-playout-401
release/v26.15.0-notes
issue-806-guard-populations
scratch/767b-poisoned
scratch/767b-control
release/v26.14.0-notes
release/v26.14.0
docs/510-skill-logo-bug-policy
fix/510-watermark-resolution-policy
fix/629-verdict-classifier-falseopens
fix/609-decisions-edit-token-scope
issue-135-clear-to-none
release/v26.12.0-notes
fix/409b-lastscan-api-parity
fix/401-updatechannel-mirror-422
fix/327-playlist-rename-validation
fix/410-scancancel-log-level
fix/409-447-librariesscreen-neverscanned
fix/338-zap-exit-code
fix/367-plex-budget-message
fix/310-debom-legacy-cs
ci/604-lane-rebalance
feat/388-design-mirror
feat/247-test-ownership
feat/247-primary-action
feat/357-player-owned-playback
feat/357-jellyfin-plugin-poc
fix/289-mcp-hardening
issue58-mcp
feat/244-channels-extract
ci/auto-bump-prod-compose
feat/multi-rerun-collections-api
feat/collections-api
feat/quick-wins
feat/185-docs-part2
feat/140-collections-screen
feat/146-channel-edit
feat/147-classic-ui-link
issue22-renovate-dashboard
feat/91-cutover
feat/63-composite-create
feat/65-library-browse
feat/85-epg
feat/86-schedule-editor
feat/109-dashboard-data
feat/99-session-tracking
fix/dockerfile-node-tag
feat/59-spa-foundation
docs/59-ui-redesign-brief
feat/102-json-guide
feat/111-schedule-durations
feat/104-artwork-upload
feat/103-media-sources-api
feat/playouts-read-api
feat/108-health-api
feat/105-picker-list-endpoints
issue-97-channel-state-api
issue42-jellyfin-musicvideos
issue46-rest-api-error-contract
dependabot/nuget/ErsatzTV.FFmpeg.Tests/multi-d307a2e06f
qsv-improvements
hdr-vulkan-cuda-test
v26.16.0
v26.15.0
v26.14.0
v26.13.0
v26.12.0
v26.11.0
v26.10.0
v26.9.0
v26.8.0
v26.7.0
blazor-final
v26.6.0
v26.5.0
v26.4.0
v26.3.1
v26.3.0
v26.2.0
v26.1.1
v26.1.0
v25.9.0
v25.8.0
v25.7.1
v25.7.0
v25.6.0
v25.5.0
v25.4.0
v25.3.1
v25.3.0
v25.2.0
v25.1.0
v0.8.8-beta
v0.8.7-beta
v0.8.6-beta
v0.8.5-beta
v0.8.4-beta
v0.8.3-beta
v0.8.2-beta
v0.8.1-beta
v0.8.0-beta
v0.7.9-beta
v0.7.8-beta
v0.7.7-beta
v0.7.6-beta
v0.7.5-beta
v0.7.4-beta
v0.7.3-beta
v0.7.2-beta
v0.7.1-beta
v0.7.0-beta
v0.6.9-beta
v0.6.8-beta
v0.6.7-beta
v0.6.6-beta
v0.6.5-beta
v0.6.4-beta
v0.6.3-beta
v0.6.2-beta
v0.6.1-beta
v0.6.0-beta
v0.5.8-beta
v0.5.7-beta
v0.5.6-beta
v0.5.5-beta
v0.5.4-beta
v0.5.3-beta
v0.5.2-beta
v0.5.1-beta
v0.5.0-beta
v0.4.5-alpha
v0.4.4-alpha
v0.4.3-alpha
v0.4.2-alpha
v0.4.1-alpha
v0.4.0-alpha
v0.3.8-alpha
v0.3.7-alpha
develop
v0.3.6-alpha
v0.3.5-alpha
v0.3.4-alpha
v0.3.3-alpha
v0.3.2-alpha
v0.3.1-alpha
v0.3.0-alpha
v0.2.5-alpha
v0.2.4-alpha
v0.2.3-alpha
v0.2.2-alpha
v0.2.1-alpha
v0.2.0-alpha
v0.1.5-alpha
v0.1.4-alpha
v0.1.3-alpha
v0.1.2-alpha
v0.1.1-alpha
v0.1.0-alpha
v0.0.62-alpha
v0.0.61-alpha
v0.0.60-alpha
v0.0.59-alpha
v0.0.58-alpha
v0.0.57-alpha
v0.0.56-alpha
v0.0.55-alpha
v0.0.54-alpha
v0.0.53-alpha
v0.0.52-alpha
v0.0.51-alpha
v0.0.50-alpha
v0.0.49-prealpha
v0.0.48-prealpha
v0.0.47-prealpha
v0.0.46-prealpha
v0.0.45-prealpha
v0.0.44-prealpha
v0.0.43-prealpha
v0.0.42-prealpha
v0.0.41-prealpha
v0.0.40-prealpha
v0.0.39-prealpha
v0.0.38-prealpha
v0.0.37-prealpha
v0.0.36-prealpha
v0.0.35-prealpha
v0.0.34-prealpha
v0.0.33-prealpha
v0.0.32-prealpha
v0.0.31-prealpha
v0.0.30-prealpha
v0.0.29-prealpha
v0.0.28-prealpha
v0.0.27-prealpha
v0.0.26-prealpha
v0.0.25-prealpha
v0.0.24-prealpha
v0.0.23-prealpha
v0.0.22-prealpha
v0.0.21-prealpha
v0.0.20-prealpha
v0.0.19-prealpha
v0.0.18-prealpha
v0.0.17-prealpha
v0.0.16-prealpha
v0.0.15-prealpha
v0.0.14-prealpha
v0.0.13-prealpha
v0.0.12-prealpha
v0.0.11-prealpha
v0.0.10-prealpha
v0.0.9-prealpha
v0.0.8-prealpha
v0.0.7-prealpha
v0.0.6-prealpha
v0.0.5-prealpha
v0.0.4-prealpha
v0.0.3-prealpha
v0.0.2-prealpha
v0.0.1-prealpha
Labels
Clear labels
ad-hoc
api
bug
ci-cd
content
dependencies
enhancement
frontend
in-progress
jellyfin
parked
priority: high
priority: low
priority: medium
review
security
One-off / ad-hoc work not tracked by a dedicated issue
REST API / HTTP endpoints
Something isn't working
Build, test, deploy pipeline
Channel content / schedules / playlists
Dependency updates (Renovate)
New feature or improvement
ChicoryTV React SPA frontend
Claimed by an active session — do not pick up
Jellyfin tuner / IPTV integration
Excluded from automatic queue pickup; work only when explicitly selected
Adversarial review finding
Security / vulnerability fix
Milestone
No items
No Milestone
Projects
Clear projects
No projects
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: timothy/ersatztv#69
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Concept borrowed from PseudoTV (its signature feature). Relates to the redesign #59 and complements the manual create-channel builder (epic #62) as a second creation mode.
Goal
"Install it and it builds a lineup for you." A wizard that auto-generates whole channels from existing library metadata, so a large library becomes a full channel lineup with little manual work.
Scope
Why
The single biggest concept PseudoTV has that ErsatzTV lacks. Establishes the "automatic-first" mental model alongside our current "manual-first" one.
Notes
Related: #59, #62.
Delivery plan (2026-07-16)
Shipping a 3-axis MVP first (TV Show / TV Genre / Movie Genre) with the full pipeline (enumerate → preview → select → bulk-create), then adding the remaining axes incrementally. Design:
docs/superpowers/specs/2026-07-16-auto-tuning-design.md.Done-when
#EXTINF+group-title+ XMLTV<channel>verified)8e82673eclaiming — session started 2026-07-16 20:54 CEST (Claude Code / Opus 4.8 orchestrator).
Context: the ChicoryTV rewrite + go-live arc (#237) is complete, so this is a post-arc backlog pickup. #69 is the lowest-numbered eligible
priority: mediumitem; its key dependency #63 (composite create-channel-from-lineup endpoint) is already shipped. This is a large greenfield feature, so I'm starting with a design/brainstorming pass (scope, axes, preview/bulk-create UX, reuse of Collections/Smart Collections + #63 composite create) before any implementation — likely multi-session. Will post the design direction here for sign-off before building.PR1 (backend) opened → #379. CI running.
Grounded the design in the PseudoTV Live inspiration (its nine library axes, per-type ordering, "reserve a channel-number block") and deliberately fixed its two weaknesses: no preview/selection, and destructive wipe-and-rebuild. Our version is additive with a preview→select→bulk-create flow.
What PR1 ships — three
/api/v1endpoints for the 3-axis MVP (TV Show / TV Genre / Movie Genre):POST /channels/auto-tune/preview— EF distinct+count enumeration → proposed channels (no writes)POST /channels/auto-tune— per proposal: create a SmartCollection (server-generated Lucene query) → call #63CreateChannelFromLineup→ per-channel Created/Skipped/FailedDesign decisions (in
docs/decisions.md): enumerate via EF / persist via SmartCollection (live queries), additive reserve-block numbering + name dedup, server-owned query generation. 16 new NUnit tests; cold-context whole-branch review → MERGEABLE after two Important fixes (null-body 500 guard; SmartCollection rollback on failed/skipped channel).Next: PR2 = SPA wizard + live-E2E, which closes #69. Remaining six axes become follow-up issues after the MVP.
PR1 (backend) MERGED to main → #379 (CI green: Build & test, Formatting, API-docs-in-sync, decisions.md append-only, migrations, E2E all passed). Remote branch deleted.
Backend for the 3-axis MVP is live on
main:POST /api/v1/channels/auto-tune/preview+POST /api/v1/channels/auto-tune, orchestrating EF metadata enumeration → SmartCollection generation → #63 composite create, additive/non-destructive. 16 NUnit tests; cold whole-branch review + fix-commit re-review clean.Remaining for #69: PR2 = the SPA auto-tune wizard + live-E2E (seed a real library, preview → create, verify M3U/XMLTV). #69 closes with PR2. The other six axes become follow-up issues after the MVP.
Leaving open for PR2.
Claiming for PR2 (SPA wizard) — session started 2026-07-16 (Claude Code / Opus 4.8).
Taking the design-first route via the
/design-syncworkflow before implementing inweb/.Design prototype pushed to Claude Design (
ChicoryTV Design Systemproject) + mirrored indesign-system/on the branch:templates/chicorytv-admin/AutoTune.jsx— the interactive 3-step wizard prototypedesign_handoff_auto_tune/README.md— the implementation spec (layout, pane-by-pane, API mapping table) subagents/impl build fromapp.html+ a new Auto-Tune sidebar entry (iconSparkles, right after New Channel)The screen is a 3-step wizard driving the two PR1 endpoints, additive/non-destructive:
POST …/auto-tune/preview) — proposals grouped by axis, per-row + per-group checkboxes, allocated number, item count; already-existing names greyed + deselected (dedup).POST …/auto-tune) — Created/Skipped/Failed Stat tiles + per-channel result list.Verified rendering across all three steps in the warm + cool accent themes (fully token-driven, theme-aware). Paused for visual review in Claude Design before I build
web/src/screens/AutoTuneScreen.tsx.Design iterated + PR2 scope locked.
The prototype was iterated in Claude Design (working-copy project
4eb64b16) to add a per-channel DetailPanel — a "Configure" button on each Preview row opening a full per-channel editor (identity/image, shuffle/always-playing, template + Advanced overrides, weighted content sources, exclude/add-untagged, example schedule). Synced back intodesign-system/(commit onfeat/69-auto-tune-spa).That DetailPanel needs backend the PR1 endpoints don't have, so per design-first it's deferred — filed as arc #383 (children #384 enumerate smart-collection members, #385 per-channel overrides + rotation weights in create, #386 the SPA panel), all
priority: low, to start after this closes.PR2 (implementing now) = the 3-step wizard only — Configure → Preview → Create — on the existing PR1 endpoints (no per-row Configure). New screen
web/src/screens/AutoTuneScreen.tsx+api/autoTune.ts, route/app/auto-tune, tests, docs. Live-E2E + independent review before the PR. #69 still closes with this PR2.Closed — Auto-Tune MVP shipped (PR2 #389 merged to main)
What shipped (PR2): the
/app/auto-tuneSPA wizard — the automatic-first channel-creation mode. Three steps on the PR1 endpoints, additive/non-destructive:Files:
web/src/api/autoTune.ts,web/src/screens/AutoTuneScreen.tsx(+ tests), route/nav wiring, App nav-smoke. Docs:domain-model.md(route) +blazor-route-parity.md(net-new SPA screen).Design: iterated in Claude Design, synced to
design-system/+ pushed to the canonical project. Visuals follow the approved prototype.Verification:
8e82673e(fixed: selection keyed byaxis+valueto avoid same-name coupling + a regression test; zero-templates UX).#EXTINF/group-title) and XMLTV (<channel>).Deferred (design-first): the per-channel DetailPanel from the design iteration needs new endpoints → #383 (children #384/#385/#386). Remaining six axes remain post-MVP follow-ups.
Both PRs merged; all Done-when satisfied. Closing.