An electronic program guide (EPG) shows what’s on each channel and when. The iptv-org EPG project collects TV schedule data and publishes it in XMLTV format, which many IPTV players and media centers can read. This guide explains what the project provides, how to add its listings to a compatible app, and how to fix common guide problems.
What Is the iptv-org EPG?
iptv-org/epg is an open-source project that gathers television schedule information from online sources and converts it into EPG files. Those files contain details such as program titles, descriptions, start and end times, and channel identifiers.
The project provides guide data; it does not provide TV streams or subscriptions. You’ll need a separate playlist or TV service for video. You also need a player that can load XMLTV data, such as a compatible IPTV app, Kodi setup, or media-server tool.
A crucial detail is that guide listings must be matched to channels in your playlist. The EPG identifies channels with IDs, and your player uses those IDs to connect a listing to the right stream. A guide can download successfully and still appear empty if the IDs don’t match.
How to Find the Right iptv-org EPG File
Start at the iptv-org/epg GitHub repository. Check its README and published guide links for current file locations and instructions. The project offers guide files organized by region or country; for example, a country-specific XML file is often more manageable than a large combined guide.
Choose the file that covers the channels you actually watch. A smaller regional guide can be quicker to download and easier for an app to process. Don’t assume that a country guide includes every channel available in that country: listings depend on the project’s data sources, and coverage can vary by channel and day.
Before adding a guide, check whether your playlist or app already provides an EPG URL. If so, you can use that guide instead, or compare the channel IDs with the iptv-org data. Using two guides at once may create duplicates or conflicting listings, depending on the player.
Add the Guide to a Compatible App
The exact menu names vary, but the setup usually follows the same pattern:
- Find the current XMLTV guide URL in the iptv-org repository.
- Open your player’s playlist or EPG settings.
- Add the URL as the XMLTV or external guide source.
- Save the settings and refresh or download the guide.
- Map each playlist channel to its matching EPG channel if the app doesn’t do this automatically.
Some apps let you enter a URL; others expect you to download a file and select it locally. Follow the app’s instructions for choosing a remote or local XMLTV source. If the app asks for a channel ID, use the ID listed in the guide rather than relying only on the channel’s displayed name.
Give the app time to fetch and process the listings. Larger guides can take longer, especially on a device with limited memory. Once loaded, open a channel’s program guide and check that the current show and upcoming schedule look sensible.
Fix Missing or Incorrect Listings
If the guide is blank, first confirm that the XML file loads from the URL in a browser or other XML-capable tool. A typo, outdated link, or network restriction can prevent the app from fetching it. Then refresh the EPG inside the app; some players keep an old copy until you trigger an update or restart them.
If only certain channels are missing, check channel mapping. Compare the channel ID in your playlist with the corresponding ID in the XMLTV guide. Names alone may not match: one source might use an abbreviation, a regional suffix, or different punctuation. Manually assigning the right guide channel can resolve this.
Wrong program times often point to a time-zone setting. Check the device, app, and playlist settings, and confirm whether the player converts guide times to local time. Also keep in mind that schedule data can be delayed or incomplete. The project depends on external sources, so a listing may be missing even when your setup is correct.
iptv-org EPG FAQ
Is iptv-org EPG free?
The project’s guide files are publicly available through its published resources. Your IPTV service, player, internet connection, or device may still have its own costs or requirements.
Does iptv-org EPG include live TV streams?
No. It provides schedule information, not video streams. You need a separate, legitimate playlist or TV service for channels to watch.
Why does my player show listings for the wrong channel?
The playlist and EPG may have different channel IDs, or the app may have mapped them incorrectly. Review the IDs and manually match the playlist channel to the correct guide entry.
Conclusion
The iptv-org EPG is a useful way to add XMLTV listings to a compatible IPTV setup without confusing guide data with the streams themselves. Choose a guide that fits your region, check channel IDs, and refresh the data when listings look stale. With those basics in place, you can browse schedules and upcoming programs more easily.
