Channel Templates (built-in + custom) bundling technical/behavioral defaults #64
Closed
opened 2026-07-01 23:01:55 +02:00 by timothy
·
2 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
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
No Assignees
Notifications
Due Date
No due date set.
Blocks
#89 ChicoryTV SPA: Channel Builder (primary deliverable)
timothy/ersatztv
Reference: timothy/ersatztv#64
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.
Part of #62 (Create Channel backend prerequisites). Directly satisfies a #59 goal ("better defaults and templates").
Goal
A Channel Template entity that bundles the clunky technical/behavioral settings so most channels need zero manual config.
Scope
Notes
Design approach before coding
I read the issue body plus
CLAUDE.md/docs/contributing.mdand surveyed the existing channel, schedule, playout, FFmpeg, filler, seeding, and REST API patterns.Entity shape / composition decision
I will model
ChannelTemplateas a first-class domain entity that composes existing entities by reference instead of duplicating their values:FFmpegProfileIdrequired, referencing the chosen transcode profile.WatermarkId,FallbackFillerId,PreRollFillerId,MidRollFillerId,PostRollFillerIdreferencing the existing watermark/filler preset entities.FillerKindwhere applicable.Templates will be applied at channel creation time by #63, not live-linked to channels. So deleting or editing a template will not break existing channels created from it. #63 can take
templateIdplus Advanced overrides, resolve the template, and stamp the resulting channel/schedule/playout values into the normal channel creation flow.Bundle scope
Core bundle fields I plan to persist now:
Name,Description,IsSystem.FFmpegProfileId,StreamingMode,TranscodeMode, optionalWatermarkId, optionalFallbackFillerId.PlayoutSource,PlayoutMode,IdleBehavior,StreamSelectorMode,StreamSelector, audio preference fields.PreferredSubtitleLanguageCode,SubtitleMode,MusicVideoCreditsMode,MusicVideoCreditsTemplate,SongVideoMode.ShuffleScheduleItems,RandomStartPoint,FixedStartTimeBehavior, optionalPreRollFillerId,MidRollFillerId,PostRollFillerId.I am intentionally not adding per-item graphics/deco/watermark lists or every schedule-item tail field in this slice. The entity should make #63 and the SPA create flow easy without duplicating the whole schedule editor. If review shows a necessary missing tail field, I will call it out as follow-up rather than expanding the model indefinitely.
This shape should also ease #68 later: resume/bookmark behavior can be added as new per-channel/default behavior flags without changing the composition-by-reference decision.
Built-ins and default selection
I will follow
DbInitializerprecedent used for default FFmpeg/profile/config values:IsSystem = trueand cannot be deleted.ConfigElementKey(e.g.channel_templates.default_template_id) so the create flow can preselect it without makingIsDefaultmutually exclusive state across rows.Standardas default, plusMusic videoswith music-video-friendly defaults.REST API surface
Under
/api/channel-templates, using the existing #2a API conventions (ApiResults,NotFoundError, request DTOs, routeName = ..., ProblemDetails metadata, OpenAPI contract tests):GET /api/channel-templates(GetChannelTemplates) returns templates, likely unpaged because this is a small settings list; no paging clamp needed unless I discover an existing requirement for paging here.GET /api/channel-templates/default(GetDefaultChannelTemplate) returns the configured default template.PUT /api/channel-templates/default/{id:int}(SetDefaultChannelTemplate) validates template exists and records it as default.GET /api/channel-templates/{id:int}(GetChannelTemplateById) returns one template or 404.POST /api/channel-templates(CreateChannelTemplate) creates a user template from a request DTO.PUT /api/channel-templates/{id:int}(UpdateChannelTemplate) updates a user template; system templates should reject mutation unless the existing codebase has a stronger precedent for allowing system row edits.DELETE /api/channel-templates/{id:int}(DeleteChannelTemplate) deletes only user templates; system templates return validation error and deleting the current default should be rejected unless another default is selected first.DTO shape will be ID/enums/scalars only, friendly to #63 and SPA #89: list rows can show
isSystemandisDefault, while create/update request DTOs mirror the template core bundle and leave future Advanced overrides able to reuse the same field names.Done
What was done: Implemented PR #133 (
feat/api: channel templates entity + CRUD (#64)) with a first-classChannelTemplateentity, built-inStandard/Music videostemplates, default-template selection, REST CRUD under/api/channel-templates, OpenAPI/typegen updates, and dual-provider EF migrations. Templates compose existing FFmpeg/profile/filler/watermark entities by reference and are designed to be applied at channel creation time by #63, not live-linked to channels.Root cause: n/a (feature work).
Files changed: Domain/API/Application/Infrastructure/test/OpenAPI/web typegen files for channel templates; migrations
20260706155532_AddChannelTemplates(SQLite) and20260706155538_AddChannelTemplates(MySQL).Verification: Local:
TZ=UTC dotnet build ErsatzTV.slnpassed;TZ=UTC dotnet test ErsatzTV.Tests/ErsatzTV.Tests.csprojpassed (417);TZ=UTC dotnet test ErsatzTV.Core.Tests/ErsatzTV.Core.Tests.csprojpassed (493 passed / 1 skipped);dotnet build --configuration Release --no-restorepassed; SQLite model drift passed; SQLite fresh DB migration apply passed; MySQL model drift passed;cd web && npm ci && npm run generate:api && npm run typecheckpassed. CI PR run 259 passed required jobs: Build & test (.NET) and EF migration integrity (SQLite + MySql). Image job skipped for pull_request as expected.Deferred: MySQL fresh DB apply was not run locally because no MySQL service or Docker binary was available; CI migration integrity passed it. Broader tail fields such as full graphics/deco lists remain out of scope for this slice and can be added later if #63/#89 prove they are needed.
Follow-up issues: #63 composite create-channel endpoint should consume
templateIdplus Advanced overrides and stamp values into channel/playout/schedule creation. #89 SPA flow can list templates and preselect the default. #68 remains unblocked by this template shape.Docs updated: n/a beyond PR body/design comment. API surface is captured in regenerated OpenAPI and
web/src/api/generated/v1.d.ts.Leaving #64 open for PR review/merge; PR body contains
Closes #64so merge should close it.