Jellyfin/Kodi PoC: player-owned channel playback with ErsatzTV as channel engine #357
Closed
opened 2026-07-14 20:59:41 +02:00 by timothy
·
8 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#357
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.
Goal
Run a small, high-priority feasibility PoC for a possible new direction for this fork:
The intended payoff is better video quality, playback stability, and resource use without losing the channel-surfing experience.
This is a PoC and go/no-go decision, not authorization for a rewrite.
Non-negotiable behavior to preserve
PoC scope
Build the smallest vertical slice that can answer the architecture question:
Feasibility questions
Reuse and migration safeguards
Related but not duplicate: #178 (Jellyfin control/config integration), #176 (channel-first creation/wizards), and #58/#62 (MCP/API create-channel foundations).
Done when / go-no-go gate
Claiming #357 for the Jellyfin/Kodi player-owned playback feasibility PoC. I’ll keep the experiment isolated, preserve M3U/XMLTV/API behavior, document architecture/reuse findings and measured evidence, and run the project completion protocol before handoff.
Done (phase-one feasibility slice; issue remains open)
What was done: Added the authenticated scheduled-source read and a standalone, default-off Jellyfin 12.0-rc2 Live TV probe; verified guide import, native Jellyfin source selection/transcoding, schedule offsets, one programme boundary, and playback-history behavior in a disposable loopback clone. PR #358 records a no-go for replacing the continuous stream with a server-plugin-only path on the current Jellyfin contract.
Root cause: n/a — architecture feasibility PoC. The blocking contract gaps are that
ILiveTvServicereceives neither the schedule-derived initial offset nor a viewer/session identity, stock Jellyfin web tunes at zero, and Jellyfin does not retune an already-open native source at the EPG boundary.Files changed: Scheduled playback-source API/DTO/handler/controller plus OpenAPI/generated types; standalone Jellyfin plugin and focused tests; architecture evidence, reuse matrix, decision, and rollback documentation.
Verification: Local full restore/build/test passed; final full solution test run passed (plugin 12/12, application 1599/1599, plus all other solution projects). Web API generation, lint, typecheck, 761 tests, and production build passed. Scoped formatting and diff checks passed. Exact-head cold review reported no findings at
97397906e3771baa68355248b3a6bf8f4d4733d0. Gitea Actions run #641 is green: .NET, SQLite/MySQL migration integrity, formatting, API-doc sync, decisions append-only, and docs reminder all passed; the PR-only image-push job skipped as designed. Disposable containers, volumes, images, snapshots, binaries, and helper scripts were removed.Deferred: Kodi implementation/tuning, a second boundary, finite-file EOF, long A/V stability, and visual comparison were deliberately stopped because initial position and the first clean boundary had already failed the required architecture. Per-user backing-library authorization also remains unavailable through this provider seam. Retain the existing M3U/XMLTV continuous path.
Follow-up issues: None opened. Keep #357 open under its original acceptance gate; reconsider only after an upstream Jellyfin offset/session/transition seam or a deliberately thin client companion is proven.
Docs updated:
docs/player-owned-playback-poc.md,docs/decisions.md, the docs index, endpoint index, and plugin README.PR: #358
Parked architecture options after the live PoC
This records the three paths discussed after the stock Jellyfin result. It preserves the research; it does not authorize implementation. In every path, ChicoryTV remains authoritative for channels, schedules, wizards, advanced configuration, API, and MCP. Jellyfin-side configuration should stay minimal.
1. Preferred contingency: private Jellyfin Live TV fork
Continue using Jellyfin's existing Live TV guide, channel UI, virtual-channel session/history behavior, and native direct-play/transcode pipeline. Maintain a small private patch stack across Jellyfin server/model and
jellyfin-web:ILiveTvServiceimplementations, carrying current schedule offset, next transition, and user/session context;The boundary work is still needed even though native Live TV is reused: its current stream model expects one continuous/infinite source, while this path replaces finite library files. A paused or buffered viewer can therefore be behind the wall-clock EPG unless the fork defines the rule above. Other Jellyfin clients remain stock and would not gain these semantics unless patched too.
Expected cost is moderate initial work, not a Jellyfin rewrite: additive server/model hooks, web-player behavior, tests, and a custom image. Small upstream releases may accept the commits unchanged, but every upgrade still needs a rebuild and live smoke test; major playback/Live TV refactors may require rebasing. Do not depend on upstream acceptance.
2. Backup: plugin-backed ChicoryTV TV-mode web UI
Ignore Jellyfin Live TV and provide a dedicated EPG/channel-player experience that owns channel surfing, current-item offset, and boundary switching while using normal Jellyfin playback/transcoding. This avoids a Jellyfin fork but owns substantially more client/UI behavior. Official mobile/TV clients would not inherit it, and backing-item history suppression would need an explicit design.
3. Current fallback: keep ErsatzTV transport and tune it
Retain the supported continuous M3U/XMLTV path for Jellyfin/Kodi and create a separate performance-tuning backlog item. Measure actual FFmpeg commands, startup/channel-change latency, CPU/GPU, buffering, and quality before changing remux/direct-stream opportunities, hardware acceleration, presets, GOP/keyframes, segment sizing, audio, or subtitle behavior.
Decision / status
Park all three implementation directions for now and return to the main handoff/queue. #357 remains open/parked as the research record. PR #358 remains an evidence/probe PR; this comment neither merges it nor turns the probe into a supported product surface.
Claiming this issue for the current queue session. I’ll start with bounded architecture and feasibility reconnaissance, define the smallest vertical PoC and its measurement plan, then implement and verify the slice against the issue’s go/no-go criteria. I’ll record any environment-dependent blocker explicitly rather than broadening the experiment.
Releasing this claim after reading the issue comments. The completed phase-one PoC already records the current server-plugin path as a no-go, and the later architecture note explicitly parks all three follow-on implementation directions and says it does not authorize implementation. Proceeding would therefore expand scope beyond the issue’s current authorization. No code or issue state beyond this temporary claim was changed.
Claiming this for the current ChicoryTV queue session. I’ll first reconcile the existing discussion with the live Jellyfin/Kodi integration surfaces, then build the smallest isolated, reversible vertical PoC and report evidence against every go/no-go criterion. No rewrite or destructive schema change is implied by this claim.
Releasing today’s automatic queue claim after operator clarification: this is a parked experimental PoC, not a normal queue pickup. Added the
parkedlabel, which means exclude from automatic ranking and work only when explicitly selected by the user. No implementation work was started.Closing as part of backlog grooming (2026-07-17). Convention decided this session:
parked= no concrete plans to work on → close rather than leave lingering (reopen instantly if/when we decide to pursue the player-owned-playback PoC). The idea and rationale are preserved in the body above; related threads #178, #176, #58/#62 remain open.