Documentation

How to fix a missing or wrong IPTV TV guide

Load an XMLTV source, auto-match channels to the guide and fix the ones that are still empty or wrong.

If your IPTV app shows an empty or wrong programme guide, the usual cause is that the channels are not linked to the right guide data. The guide uses an ID per channel (the tvg-id), and the provider’s IDs are often missing or do not match the guide source. Sift lets you load a guide source and links channels to it automatically.

1. Load a guide source

  1. Press EPG in the top bar.
  2. Press Use provider EPG, or paste your own XMLTV address (compressed .xml.gz feeds work) and press Add & Fetch.
  3. Check that the source shows a channel count. If many channels stay unmatched later, add a second source.
The EPG Sources window with one loaded XMLTV source
A loaded source: its address, when it was loaded and how many channels it has.

2. Match channels to the guide

  1. Choose EPG (all) → Assign EPGs. Sift matches every visible Live channel and keeps any ID that is already set.
  2. Read the summary: assigned, already set and unmatched.
  3. For unmatched channels, pick a suggestion or press Ignore if the guide simply does not cover that channel.
Auto EPG results listing channels that need review
Channels Sift was not sure about are listed, with suggestions when there are any.

3. Check one channel

Press the guide icon on a channel. The panel shows the assigned ID and what is on now and next, a quick way to see whether the match is right. You can search your loaded guide there and pick a different channel by hand.

Common reasons a guide is wrong or empty

SymptomLikely causeWhat to do
No guide for any channelNo source loaded, or the source failed to load.Open EPG, check the status dot, reload the source.
Guide for some channels onlyThe source does not carry every channel.Add a second XMLTV source and run Assign EPGs again.
Wrong country’s scheduleThe category name carries no country prefix, so Sift cannot tell which one to prefer.Rename the category with a prefix such as “UK|”, or pick the ID by hand.
Numbered siblings mixed upProvider naming differs from the guide.Sift never matches “Sports 12” to “Sports 13”; fix the odd one by hand.
Guide shows in Sift but not in the TV appThe app has not reloaded the guide.Refresh the playlist or guide in the app.

Keep going