Fix M3U tvg-logo URLs hardcoding localhost #1
Closed
opened 2026-02-26 23:45:44 +01: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
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#1
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.
Problem
The M3U playlist generated by ErsatzTV hardcodes
http://localhost:8409fortvg-logoURLs. When Jellyfin (running in a separate Docker container) tries to fetch these logos,localhostresolves to Jellyfin itself — not ErsatzTV. This causes channel logos to break after every Jellyfin guide refresh.Root Cause
Two code paths generate logo URLs:
ChannelPlaylist.ToM3U()(ErsatzTV.Core/Iptv/ChannelPlaylist.cs, lines 65-71) — correctly uses_scheme://{_host}{_baseUrl}from the incoming request for uploaded artwork logos (line 70), but the fallback generated logo path at line 65 also uses{_scheme}://{_host}correctly.ChannelLogoGenerator.GenerateChannelLogoUrl()(ErsatzTV.Core/Images/ChannelLogoGenerator.cs, line 82) — hardcodeshttp://localhost:{Settings.StreamingPort}. This static method may be used in contexts where the request host is unavailable.Investigation Needed
GenerateChannelLogoUrl()to understand where the hardcoded localhost actually leaks into the M3U_hostparameter inChannelPlaylistis being correctly set when Jellyfin fetches the M3U viahttp://ersatztv:8409/iptv/channels.m3u(the Host header should beersatztv:8409)IptvControllercorrectly passes the request scheme/host through to the MediatR queryCurrent Workaround
Script that downloads logos from ErsatzTV and base64-uploads them to Jellyfin's
/Items/{id}/Images/PrimaryAPI. Documented inserver-managementrepo. Tracked there as issue #171.Investigation (paused — resuming after #3/#4 CI/CD lands)
Root cause confirmed. Live test against the running
ersatztvcontainer shows thetvg-logohost is purely a function of the incomingHostheader — there is no hardcoded localhost in the M3U/XMLTV path:ChannelPlaylist.ToM3U()(M3U) andGetChannelGuideHandler{RequestBase}(XMLTV) both correctly useRequest.Scheme/Request.Host/Request.PathBase.http://localhost:{StreamingPort}inChannelLogoGenerator.GenerateChannelLogoUrl()is used only byWatermarkSelector.cs(FFmpeg overlay, in-container — correct there). It's a red herring for this issue.So the broken
localhost:8409URLs were baked in because a client fetched ErsatzTV withHost: localhost:8409(misconfigured Jellyfin tuner/XMLTV URL). The operational fix (use a Jellyfin-resolvable host, neverlocalhost) belongs toserver-management(#171).Planned durable fix (this repo): ErsatzTV has no advertised/base-URL setting today — every absolute URL is hostage to the request
Host. Add an optionaliptv.base_urlConfigElement (no EF migration needed;ConfigElementis key/value) + a "Base URL" settings field, wired intoGetChannelPlaylistHandler+GetChannelGuideHandlerto override scheme/host/base when set. Cover with unit tests onChannelPlaylist.ToM3U().Full write-up in
docs/m3u-xmltv.md. Deferring implementation until CI/CD test/prod envs (#3, #4) exist so changes can be tested safely before deploy.Closing — root cause is configuration/topology, not a code bug. No code change.
Re-investigated from scratch (the earlier "confirmed" was based on one curl test and several unverified assertions). This time I looked at the actual live settings/logs/code on bumblebee (192.168.1.99), all read-only.
Key finding: the premise is stale — Jellyfin no longer tuners ErsatzTV directly
Jellyfin's
livetv.xmlhas no ErsatzTV tuner at all. Its only Live TV source is Dispatcharr (http://dispatcharr:9191/output/m3u+/output/epg), which ingests ErsatzTV and re-serves it. That funnel didn't exist when this issue was filed (Feb 2026).Evidence (all read-only)
ersatztv:8409returns correctersatztv:8409URLs — nolocalhost. The host is purely request-driven./config/cache/channel-guide/*.xml) contain the{RequestBase}placeholder — zero bakedlocalhost. Nothing is persisted as an absolute host.grep -c localhost→ 0 and 0. Sample logo (dispatcharr:9191) and sample programme icon (ersatztv:8409) both return HTTP 200image/pngfrom inside the Jellyfin container.Root cause
Configuration/topology, not code. The historical
http://localhost:8409logo URLs were produced because a client fetched ErsatzTV withHost: localhost:8409— ErsatzTV faithfully echoed it, andlocalhostfrom a separate Jellyfin container points at Jellyfin itself. That request path no longer exists (everything goes through Dispatcharr, fetched viaersatztv:8409). Not reproducible today.Corrections to the prior investigation
ChannelLogoGenerator.GenerateChannelLogoUrl()localhost — confirmed only callers areWatermarkSelector.cs(×4), an in-container FFmpeg overlay. Red herring (as previously noted). ✔KnownProxiesandKnownNetworksinStartup.cssetscheckKnownIps = false, which trusts all proxies, not none. And there's no proxy between Jellyfin↔ErsatzTV anyway. Not the cause.{RequestBase}only. ✔Latent fragility (noted, not broken)
The EPG Jellyfin consumes still carries 3095 absolute
ersatztv:8409programme-icon URLs that work only because Dispatcharr fetches ErsatzTV with a resolvable host. ErsatzTV has no advertised/base-URL setting, so absolute URLs remain hostage to the requestHost. Documented as an optional, not-committed hardening (iptv.base_urlConfigElement — key/value, no EF migration) indocs/m3u-xmltv.md. Deliberately not built, since the problem no longer manifests.Files changed
docs/m3u-xmltv.md— updated with the live evidence, the Dispatcharr topology, the resolution, and the optional-hardening note.Disposition
Closing as resolved by topology / configuration. Operational guidance (use a Jellyfin-resolvable host for any ErsatzTV IPTV source, never
localhost) lives withserver-management(#171). If the latent fragility ever bites, reopen / file an enhancement for the base-URL setting.Follow-up
The
jellyfinskill doc (server-management-owned) still lists ErsatzTV as a direct Jellyfin tuner and states logos break "because M3U uses localhost:8409" — now stale. Worth correcting in server-management.timothy referenced this issue2026-07-17 20:07:13 +02:00