Connect Your XMLTV Feed
Follow our step-by-step guides below to connect your private EPGWise guide feed to IPTV Smarters, XUI One, StreamCreed, Xtream Codes-compatible panels, Kodi, Jellyfin, TVHeadend, NextPVR, or Plex DVR.
Quick start overview
Copy Token URL
Copy your private .xml.gz feed URL from your dashboard.
Configure App
Paste the URL into your application's EPG, TV Guide, or XMLTV settings.
Sync & Enjoy
Save settings and trigger an initial guide refresh. Listings update automatically.
Dedicated Player, Panel, Media Server & DVR Setup Guides
In-depth configuration documentation for external XMLTV sources, refreshes, and channel mapping. Menu labels can vary by app or panel version.
Jellyfin Live TV Guide
Fix blank guide grids, configure .xml.gz auto-decompression, and map channels.
๐กTVHeadend XMLTV Grabber
Socket grabber scripts, cron scheduling, and channel EPG source assignment.
๐ผNextPVR XMLTV Setup
Bulk channel mapping, automated daily guide updates, and series recording.
๐ฌPlex Live TV & DVR
Replace missing regional EPG data with private custom XMLTV feeds.
๐ฎKodi PVR Simple Client
Configure remote .xml.gz URL, enable local caching, and clear PVR database.
๐ฑIPTV Smarters EPG
Add an external XMLTV URL to Smarters Player and fix blank guide mappings.
๐กEPG for IPTV Panels
General XMLTV workflow for sources, channel IDs, bouquets, and client guides.
๐งฉXUI One EPG
Import XMLTV, map stream IDs, and refresh panel bouquets or packages.
๐ ๏ธStreamCreed EPG
Add a guide source, rebuild programme data, and map authorised streams.
๐Xtream Codes EPG
Use a separate XMLTV URL with M3U, compatible players, or a panel.
โ๏ธSchedules Direct Comparison
Managed XMLTV URL vs CLI grabber scripts and free open-source scrapers.
๐Free EPG XML URL
How public dumps and GitHub UK sources differ from a private gzipped feed.
Interactive Player Setup Assistant
Select any player tab below for quick reference steps. Use the dedicated links above for full panel and app instructions.
Jellyfin Live TV
Supported Platforms: Linux, Windows, macOS, Docker, TrueNAS, Synology
Jellyfin automatically parses .xml.gz feeds in memory, providing fast guide grids, program descriptions, and station logos.
Step-by-Step Configuration
1. Open Jellyfin Live TV Settings
Log into the Jellyfin admin dashboard and navigate to Live TV under the Server section.
2. Add XMLTV Provider
Under TV Guide Data Providers, click the '+' button and select 'XMLTV'.
3. Paste Your Private URL
Enter your private .xml.gz feed URL in the 'File or URL' field.
- Example: https://epgwise.com/epg/<your-token>.xml.gz
- Ensure your URL ends with .xml.gz so Jellyfin auto-decompresses the feed.
4. Trigger Scheduled Guide Refresh
Navigate to Dashboard > Scheduled Tasks > Live TV and run 'Refresh Guide Data'.
5. Map Channels if Needed
In Live TV > Channels, select any unmapped channel to pair it with its XMLTV listing.
๐ก Pro Configuration Tips
- โขSet the 'Refresh Guide Data' scheduled task to run twice daily for up-to-the-minute schedule adjustments.
- โขEnsure your tuner device or source channels are created in Jellyfin before mapping guide listings.
๐ ๏ธ Quick Troubleshooting
Why does the guide show 'No Information Available'?
Check Dashboard > Live TV > Channels and verify each channel has a corresponding XMLTV guide listing assigned.
How do I fix offset guide times?
EPGWise listings carry exact UTC timestamps. Verify that your host server's local timezone and daylight saving time settings are accurate.
Frequently Asked Questions
What is an XMLTV feed?
XMLTV is the global standard file format for digital electronic programme guides (EPG). Your private feed URL returns an up-to-date XMLTV document that compatible players download automatically to populate channel schedules, synopses, and genre metadata.
Should I use the .xml.gz or the .xml URL?
Always use the .xml.gz (gzip compressed) URL whenever your player supports it โ it reduces bandwidth by 90% and downloads much faster. If you use a legacy player that rejects compressed files, switch to the plain .xml URL provided in your dashboard.
The guide times appear offset by an hour. How do I fix this?
EPGWise feeds carry precise UTC timestamps, and your player converts them to local time. If listings are offset by an hour, check your device's system timezone and Daylight Saving Time (DST) setting inside your player app.
Can I use EPGWise with IPTV Smarters, XUI One, StreamCreed, or Xtream Codes?
Yes, when the app or panel accepts an external XMLTV source. Add your private EPGWise URL, refresh the guide, and map XMLTV channel IDs to your authorised playlist entries or streams. EPGWise supplies guide metadata only, not video streams, playlists, or panel accounts.
Can I merge several countries into one master feed?
Yes. Choose individual countries, or select exactly 3 or 5 countries for a discounted bundle. Every selected country keeps a separate private URL. From the dashboard, create a custom guide that merges only the countries or channels you choose.
Will my channel IDs change when the feed updates?
No. Channel IDs are permanently fixed and normalized, ensuring your channel mappings, favourites, and custom logos never break.
How many devices can use my private EPG link?
Each subscription is designed for personal household use across all your family devices (supports up to 5 distinct network IP locations per 24 hours, such as home broadband and mobile). Sharing private links publicly on forums or through unauthorized third-party redistribution is blocked by automatic anti-leech rate limits. If your link is ever shared or compromised, you can rotate it with 1-click in your dashboard using the 'Regenerate Link' button.
How do I cancel, and what is the refund policy?
You can cancel anytime from Account Settings. Choose an end date or immediate cancellation in a confirmation dialog. Paid-plan access continues until the current billing period ends, with no further charges. For full refund terms, visit epgwise.com/refund.
Need Additional Assistance or Found a Bug?
Our support engineers are ready to help with player setup, guide adjustments, or missing listings at supportepgwise.com.