$ guides · 6 min read
How to add a TV guide (EPG) to your IPTV playlist
If your channels show only a name and no programme, the TV guide is missing or doesn't match the channels. Here's how the guide gets into a playlist and how to fix it.
What EPG and XMLTV are
EPG (Electronic Programme Guide) is the TV guide: titles, times and descriptions of what each channel broadcasts. For IPTV it almost always arrives as an XMLTV file, an XML document (often compressed as .xml.gz) that lists channels and programmes for the next days.
The playlist and the guide are two separate files. The player has to download both and match each channel with its programmes.
How the playlist points to the guide
The first line of an M3U playlist can contain the guide address:
#EXTM3U url-tvg="https://example.com/guide.xml.gz"
Some providers write x-tvg-url instead of url-tvg; Varpa reads both. With a server sign-in the guide comes from the server itself, so there is nothing to set.
How each channel is matched
Every channel line carries an id, and the same id must exist in the XMLTV file:
#EXTINF:-1 tvg-id="news24.example" tvg-logo="…" group-title="News",News 24
https://example.com/live/news24.m3u8
<channel id="news24.example">…</channel>
<programme channel="news24.example" start="20261121200000 +0000" stop="…">…
If tvg-id and channel id are identical, the guide appears. If they differ by even one character, that channel stays without programmes.
What you get in Varpa
- On every channel: the programme on air, a progress bar with the time left and what comes next.
- A guide grid by day and category: tap the programme on air to start the channel.
- Programme info inside the player, without stopping the video.
- The guide covers from 6 hours ago to 48 hours ahead, and is reloaded every time the playlist is imported and once a day.
If a channel has no guide data, Varpa leaves that space empty instead of showing a made-up placeholder.
Empty or wrong guide: checklist
- Is there a guide address? Open the playlist link in a browser and look at the first line. No
url-tvg? Ask your provider for the EPG link. - Does the guide link work? Paste it in a browser: it should download a file. An error page means the guide is offline.
- Do the ids match? Channels from one provider with a guide from another rarely match. Use the guide your provider supplies.
- Are the times shifted? XMLTV times include a time zone (
+0000). A guide with a wrong offset will be one or two hours off for every channel: that must be fixed by whoever publishes it. - Reload: after the provider fixes something, refresh the playlist to download the guide again.
Quick check: in the guide file, search for the tvg-id of a channel that shows nothing. If you can't find it, you have found the problem.
Questions
Why is my TV guide empty?
Usually the playlist has no guide address, the guide file is unreachable, or the tvg-id of the channels does not match the ids in the XMLTV file.
How often does the guide update?
In Varpa the guide is reloaded every time the playlist is imported and once a day, and it keeps from 6 hours ago to 48 hours ahead.
Can I use a guide from a different provider?
Only if its channel ids match the tvg-id values in your playlist. Mixing sources is the most common cause of wrong programmes.