iptvtunerr.xml

<?xml version="1.0"?>
<Container version="2">
  <Name>IPTV Tunerr</Name>
  <Repository>ghcr.io/snapetech/iptvtunerr:latest</Repository>
  <Registry>https://ghcr.io/snapetech/iptvtunerr</Registry>
  <Network>bridge</Network>
  <Shell>sh</Shell>
  <Privileged>false</Privileged>
  <Icon>https://raw.githubusercontent.com/snapetech/iptvtunerr/main/docs/assets/iptvtunerr-icon.svg</Icon>
  <WebUI>http://[IP]:[PORT:48879]/</WebUI>
  <Overview>IPTV to Plex, Emby, and Jellyfin: HDHomeRun-emulating tuner, custom merged XMLTV guide, resilient stream gateway, DVR and recording rules, VOD libraries, and an operator dashboard.</Overview>
  <Description>IPTV Tunerr turns IPTV providers and M3U sources into a polished live TV backend for Plex, Emby, and Jellyfin.[br][br][b]Sources:[/b] M3U and Xtream player_api (live, movies, series); multiple providers merged and de-duplicated with backup-stream failover; host probing and ranking; optional stream smoketest.[br][b]HDHomeRun emulation:[/b] discover.json, lineup.json, and lineup_status.json with a tuner-count limit, wizard-safe channel caps, lineup sharding, and per-instance numbering; also reads real HDHomeRun hardware.[br][b]Custom guide:[/b] layered XMLTV (provider, external, HDHomeRun, placeholder) with automatic EPG matching and repair, alias overrides, language preferences, and guide-health and EPG-doctor reports.[br][b]Stream gateway:[/b] HLS and DASH to MPEG-TS relay, optional ffmpeg remux or transcode with named profiles, shared sessions across viewers, failover, and Cloudflare-block resilience.[br][b]DVR and recording:[/b] catch-up capsules, recording rules and history, and request-driven recording for apps such as SeerrNG.[br][b]Lineup tools:[/b] Programming Manager, channel health scoring, lineup recipes, virtual channels, and API-Sports sports schedules.[br][b]VOD:[/b] movie and series catalog exposed over a FUSE mount or read-only WebDAV, with Plex library registration.[br][b]Plex tools:[/b] automatic DVR and channel registration, stale-session cleanup, and an optional Live TV entitlement proxy for shared users.[br][b]Operations:[/b] authenticated web dashboard, Prometheus metrics, event webhooks, health endpoints, and an Xtream-compatible output. Keep tuner ports on a trusted LAN or VPN.</Description>
  <Support>https://github.com/snapetech/iptvtunerr/issues</Support>
  <Project>https://github.com/snapetech/iptvtunerr</Project>
  <TemplateURL>https://raw.githubusercontent.com/snapetech-org/iptvtunerr/main/iptvtunerr.xml</TemplateURL>
  <ReadMe>https://raw.githubusercontent.com/snapetech-org/iptvtunerr/main/docs/how-to/install-on-unraid.md</ReadMe>
  <Category>MediaApp:Video MediaServer:Video Network:Proxy</Category>
  <ExtraSearchTerms>iptvtunerr iptv plex tuner hdhomerun hdhr emulator xmltv epg guide m3u xtream dvr recording vod webdav threadfin xteve jellyfin emby</ExtraSearchTerms>
  <Changes>Initial Community Applications template. Tracks the GHCR latest image published by the IPTV Tunerr release workflow.</Changes>
  <Requires>Persistent appdata and cache paths. Set a reachable IPTV_TUNERR_BASE_URL before using Plex, Emby, or Jellyfin.</Requires>
  <ExtraParams>--restart=unless-stopped --security-opt=no-new-privileges:true</ExtraParams>

  <Config Name="Tuner Port" Target="5004" Default="5004" Mode="tcp" Description="HTTP tuner, stream, playlist, and guide endpoint. Keep this on a trusted LAN or VPN." Type="Port" Display="always" Required="true" Mask="false">5004</Config>
  <Config Name="Operator Dashboard Port" Target="48879" Default="48879" Mode="tcp" Description="Authenticated Tunerr operator dashboard. Do not expose this port publicly." Type="Port" Display="always" Required="true" Mask="false">48879</Config>
  <Config Name="Appdata" Target="/var/lib/iptvtunerr" Default="/mnt/user/appdata/iptvtunerr" Mode="rw" Description="Persistent catalog and dashboard state." Type="Path" Display="always" Required="true" Mask="false">/mnt/user/appdata/iptvtunerr</Config>
  <Config Name="Cache" Target="/var/cache/iptvtunerr" Default="/mnt/user/appdata/iptvtunerr/cache" Mode="rw" Description="Persistent guide and provider caches. This directory can grow with provider data." Type="Path" Display="always" Required="true" Mask="false">/mnt/user/appdata/iptvtunerr/cache</Config>

  <Config Name="Catalog File" Target="IPTV_TUNERR_CATALOG" Default="/var/lib/iptvtunerr/catalog.json" Mode="" Description="Persistent channel catalog path." Type="Variable" Display="advanced" Required="true" Mask="false">/var/lib/iptvtunerr/catalog.json</Config>
  <Config Name="Cache Directory" Target="IPTV_TUNERR_CACHE" Default="/var/cache/iptvtunerr" Mode="" Description="Persistent cache directory." Type="Variable" Display="advanced" Required="true" Mask="false">/var/cache/iptvtunerr</Config>
  <Config Name="Dashboard State File" Target="IPTV_TUNERR_WEBUI_STATE_FILE" Default="/var/lib/iptvtunerr/webui-state.json" Mode="" Description="Persistent operator dashboard preferences and state." Type="Variable" Display="advanced" Required="true" Mask="false">/var/lib/iptvtunerr/webui-state.json</Config>
  <Config Name="Base URL" Target="IPTV_TUNERR_BASE_URL" Default="" Mode="" Description="Required URL that Plex, Emby, or Jellyfin can reach, including the host port if remapped (for example http://192.168.1.20:5004)." Type="Variable" Display="always" Required="true" Mask="false"></Config>
  <Config Name="Provider URL" Target="IPTV_TUNERR_PROVIDER_URL" Default="" Mode="" Description="Optional Xtream-style provider base URL." Type="Variable" Display="always" Required="false" Mask="false"></Config>
  <Config Name="Provider Username" Target="IPTV_TUNERR_PROVIDER_USER" Default="" Mode="" Description="Optional provider username." Type="Variable" Display="always" Required="false" Mask="false"></Config>
  <Config Name="Provider Password" Target="IPTV_TUNERR_PROVIDER_PASS" Default="" Mode="" Description="Optional provider password." Type="Variable" Display="always" Required="false" Mask="true"></Config>
  <Config Name="M3U URL" Target="IPTV_TUNERR_M3U_URL" Default="" Mode="" Description="Optional M3U source URL. Treat URLs containing credentials as secrets." Type="Variable" Display="advanced" Required="false" Mask="true"></Config>
  <Config Name="Plex URL" Target="IPTV_TUNERR_PMS_URL" Default="" Mode="" Description="Optional Plex Media Server URL for automatic tuner registration." Type="Variable" Display="advanced" Required="false" Mask="false"></Config>
  <Config Name="Plex Token" Target="IPTV_TUNERR_PMS_TOKEN" Default="" Mode="" Description="Optional Plex token for automatic tuner registration." Type="Variable" Display="advanced" Required="false" Mask="true"></Config>
  <Config Name="API-Sports Key" Target="IPTV_TUNERR_API_SPORTS_KEY" Default="" Mode="" Description="Optional server-side API-Sports key for Sports Automation." Type="Variable" Display="advanced" Required="false" Mask="true"></Config>
  <Config Name="Dashboard Username" Target="IPTV_TUNERR_WEBUI_USER" Default="admin" Mode="" Description="Username for the operator dashboard." Type="Variable" Display="always" Required="true" Mask="false">admin</Config>
  <Config Name="Dashboard Password" Target="IPTV_TUNERR_WEBUI_PASS" Default="" Mode="" Description="Required strong password for the operator dashboard." Type="Variable" Display="always" Required="true" Mask="true"></Config>
  <Config Name="Dashboard LAN Access" Target="IPTV_TUNERR_WEBUI_ALLOW_LAN" Default="1" Mode="" Description="Allow the authenticated dashboard to accept connections on the mapped LAN port." Type="Variable" Display="advanced" Required="true" Mask="false">1</Config>
  <Config Name="Timezone" Target="TZ" Default="Etc/UTC" Mode="" Description="Container timezone." Type="Variable" Display="advanced" Required="false" Mask="false">Etc/UTC</Config>
</Container>