EPG Sources
EPG URL Guide: How to Add and Test a Guide Source
An EPG URL tells a compatible player where to download programme-guide data. The address may look simple, but typing errors, expired credentials, server responses, and incorrect playlist assignment can all leave the guide blank.
Published September 2, 2026
What an EPG URL points to
The URL normally returns an XMLTV document or a compressed version of one. It may include an account-specific token or username and password in the query string. Treat that address like a credential rather than a public link.
An EPG address is not the same as the M3U playlist address. Some services provide both together, while others require you to add the guide separately and associate it with a playlist inside the player.
Test the URL privately
Copy the complete address into a trusted browser or client on your own device. A valid response may display XML, download a file, or return compressed data. An account error, HTML login screen, expired-token message, or empty response means the player will not receive usable guide data.
Do not use public URL-checking services for credential-bearing sources. Redact usernames, passwords, tokens, and full query strings from screenshots and support messages.
Add the source to an IPTV player
In the app settings, open EPG, TV guide, or data sources and choose the option to add a source. Paste the URL exactly, label it clearly, and assign it to the relevant playlist if the app asks. Then run one update and wait for completion.
If the app rejects the address immediately, check for leading or trailing spaces and make sure the complete https:// or http:// prefix is present. Prefer HTTPS when the provider supports it.
Why a working URL can still show a blank guide
A successful download proves only that data was returned. The file may not contain current programme records, may cover different channels, or may use channel IDs that do not match the playlist. Check one known channel in the XMLTV source and compare its ID with the playlist tvg-id.
Also confirm that the source is assigned to the active playlist. This is a frequent problem in players that support multiple lists and multiple EPG sources.
Common EPG URL errors
A 401 or 403 response usually points to authorization, while a 404 suggests the path no longer exists. A server error may be temporary. Repeatedly clearing the player will not solve any of those source responses.
If the URL redirects, most modern players follow it, but not every implementation behaves the same way. Use the final HTTPS address supplied by the provider when possible.
FAQ
Frequently asked questions
What should an EPG URL look like?
It is a web address that returns XMLTV or compressed XMLTV data. The exact path varies and does not have to end in .xml.
Is it safe to share my EPG URL?
Not if it includes account details or a private token. Treat it as a credential and redact it from public posts, screenshots, and validators.
Can I use an EPG URL as an M3U playlist?
Usually not. The guide URL contains schedule data, while an M3U URL describes channel or stream entries. Add each in the correct player field.