Skip to content
Jellyfin Live TV Configuration

How to Set Up XMLTV Guide Data in Jellyfin

Jellyfin XMLTV (also searched as XMLTV Jellyfin) is a paste-in programme file, not a tuner plugin. If Live TV shows “No Information Available”, add an XMLTV URL under TV Guide Data Providers. A gzipped EPGWise .xml.gz feed fills listings (up to 7 days depending on country), episode synopses, and channel logos.

⚙️ Step-by-Step Setup Instructions

1

Open Jellyfin Dashboard & Live TV

Log into your Jellyfin web interface with an administrator account. Click the menu icon (top left), select Dashboard, and click Live TV in the sidebar under the Server section.

Tip: Ensure your Tuner Device (e.g. HDHomeRun or tuner source) is set up under Live TV before mapping guide data.

2

Add an XMLTV Guide Provider

Scroll down to the TV Guide Data Providers section. Click the + (Add) button and choose XMLTV from the dropdown options.

3

Paste Your Private Feed URL

In the File or URL field, enter your private EPGWise feed URL:

https://epgwise.com/epg/YOUR_TOKEN.xml.gz
💡 Note on .xml.gz compression: Jellyfin will automatically decompress gzipped listings on the fly, saving bandwidth and processing time. Make sure your URL ends with .xml.gz so Jellyfin knows to unpack it.
4

Save & Refresh Guide Data

Click Save at the bottom of the dialog. Jellyfin will register the provider. To populate the guide immediately:

  • Go to Dashboard > Scheduled Tasks
  • Find Refresh Guide Data under Live TV
  • Click the play button (▶) to run the task
5

Map Any Blank Channels (Optional)

Jellyfin automatically pairs guide data with your channels by name. If any channel remains blank:

  • Go to Dashboard > Live TV > Channels
  • Click the three dots (⋮) or edit icon next to the blank channel
  • Under Channel Guide Mapping, select the matching channel name from your XMLTV guide
  • Click Save

Troubleshooting Jellyfin Guide Issues

Guide is stuck at “0% Loading”

Check that your Jellyfin server has outbound internet connectivity to fetch HTTPS URLs. If your server is behind a strict firewall, verify that epgwise.com on port 443 is permitted.

Guide timestamps are offset by an hour

EPGWise publishes listings in standardized UTC format with explicit offsets. Ensure your Jellyfin host operating system has its system timezone and daylight saving time correctly configured.

Get Private XMLTV Guide Data for Jellyfin

Reliable, no-stress listings for every supported country. Fast .xml.gz compression, transparent channel logos, 7-day free trial where eligible.