IPTV Simple Client Not Working: Check the Playlist Format
IPTV simple client not working almost always traces to how it parses your M3U or Xtream playlist. Here's where to look.
Updated August 2026
IPTV Simple Client Not Working: Check the Playlist Format
IPTV simple client not working is usually a parsing problem, not a broken line, since this Kodi add-on is strict about the exact format of the playlist and guide file you give it.
IPTV simple client not working is usually a parsing problem, not a broken line, since this Kodi add-on is strict about the exact format of the playlist and guide file you give it. A malformed M3U URL, a mismatched EPG (program guide) address, or a Kodi update that changed how add-ons load will all produce the same blank or frozen channel list, even when the underlying service works fine everywhere else.
The numbers
What the figures actually say
- ~18,000 visible channels
- Player stability limit
- ~6 seconds
- Live segment length
- ~5 minutes
- Activation time
- unlimited
- Installs allowed
In detail
Treat it as a parsing problem first
Does the channel list load at all, or does it load blank?
If the add-on opens but shows zero channels, the M3U playlist URL itself is the most likely fault, either it's mistyped, expired, or pointed at the wrong path. If the list loads but individual channels won't play, the playlist parsed fine and the fault has moved downstream to the stream URLs themselves or your connection. These are different problems with different fixes, so check which one you actually have before changing any setting in the add-on. A blank list means the fault is entirely in that one URL field, while a populated but unplayable list points you toward the stream and your network instead.
Why does the guide show nothing even though channels play?
The EPG (electronic program guide, the on-screen schedule) uses a separate XMLTV address from the channel playlist, and IPTV Simple Client matches guide entries to channels by an ID field that has to line up exactly between the two files. A mismatch there leaves channels playing perfectly with a blank or wrong guide, which looks like a bigger fault than it is. Re-entering the EPG URL and confirming the update interval in the add-on's settings resolves most of these. It's a narrow, fixable mismatch, not a sign anything is wrong with your subscription or the channels themselves.
Did a Kodi update break the add-on itself?
Kodi version updates occasionally change how PVR add-ons like IPTV Simple Client load or how they handle cached data, which is a distinct and recurring cause separate from anything about your playlist or your service. If the add-on worked before a Kodi update and stopped right after, check the add-on's own version against what the current Kodi release expects, and clear its cached data before re-entering your playlist URL. This timing match, working before the update and broken right after, is usually enough on its own to confirm the cause.
Is it the add-on, or is it your connection?
Test the same M3U URL directly in VLC or another player on the same network. If it plays there, the fault is scoped to how IPTV Simple Client is parsing or caching the playlist, not your line or your internet. If it fails in VLC too, the problem sits upstream of the add-on entirely, and no setting inside Kodi will fix it. This cross-check takes under a minute and rules out half the guesswork, and it's the same test worth running any time a player app of any kind starts behaving strangely.
What causes it, and what fixes each cause
The add-on opens but the channel list is completely blank
- What is happening
- The M3U playlist URL is mistyped, expired, or pointed at the wrong path, so the add-on has nothing valid to parse
- What fixes it
- Re-enter the URL carefully, checking for extra spaces or the wrong protocol prefix, and test it directly in a browser or VLC first.
Channels appear in the list but individual ones won't play
- What is happening
- The playlist parsed correctly; the fault moved downstream to the stream URLs themselves or your connection
- What fixes it
- Test the same stream URL in VLC. If it fails there too, the problem is upstream of the add-on entirely.
Channels play fine but the program guide is empty or wrong
- What is happening
- The EPG uses a separate XMLTV address from the playlist, and its channel ID field doesn't match the ID used in your playlist
- What fixes it
- Re-enter the EPG URL specifically and confirm both files use matching channel IDs.
Everything worked until a Kodi version update, then the add-on stopped loading properly
- What is happening
- Kodi updates occasionally change how PVR add-ons load or handle cached data, a distinct cause separate from your playlist or service
- What fixes it
- Check the add-on's version against what the current Kodi release expects, then clear its cached data.
Step by step
- 1
Confirm the M3U URL loads outside the add-on
Paste it into a browser or VLC. If it fails there, the URL itself is the problem, not IPTV Simple Client's settings.
- 2
Check whether the list is blank or just individual channels fail
A blank list points to the playlist URL. Failing individual channels point downstream to the stream itself.
Tip · These need different fixes, so confirm which one you have before changing settings.
- 3
Re-enter the EPG URL separately from the playlist
The guide has its own address and its own channel ID matching requirement, independent of whether channels play.
- 4
Clear the add-on's cached data
This resolves stale entries left over from a previous playlist or a Kodi update without needing to reinstall anything.
- 5
Check the add-on's version against your Kodi version
If a recent Kodi update coincides with the problem, a version mismatch between Kodi and the add-on is a likely cause.
- 6
Cross-test the same playlist in a dedicated app
Try the same M3U or Xtream login in TiviMate or IPTV Smarters. If it works there, the fault is specific to how Kodi's add-on parses it.
Verified service facts
Confirmed
Continuing to play audio when a video app is minimized or the screen is off is a feature the app has to specifically build, not something granted automatically by the platform — an app without that support simply stops playback when it loses the foreground.
Confirmed
Aggressive battery-optimization settings on some Android devices can suspend a streaming app's background processes between actions, which shows up as playback stopping or the app needing to reload after switching away and back.
Confirmed
Activation credentials are typically case-sensitive, so a username or password typed with the wrong capitalization fails silently as an incorrect-credential error rather than being auto-corrected.
Related reading
IPTV TV Guide Not Working: Blank, Shifted, or Partial
IPTV tv guide not working splits into three faults: blank, filled but hours out, or filled for some channels only. Each has its own cause and its own fix.
ViewIPTV Some Channels Not Working: Why Only That Group Fails
IPTV some channels not working while the rest play fine is a source or group-level fault. Here is how to prove which one it is before changing settings.
ViewIPTV Subtitles: Why One Channel Has Them, Another Doesn't
IPTV subtitles depend on the channel's source and your player app, not your account. Here's how captions actually work and why they vary.
ViewBest IPTV Box Reddit Picks: Hardware vs. What Actually Lags
Best iptv box reddit threads argue hardware, but players wobble above ~18,000 channels. What a box fixes, what it can't, and why $10/month is the real cost.
ViewTop Rated IPTV Box: The Specs That Actually Matter
A top rated IPTV box comes down to RAM, HEVC decoding and wired ethernet. Here are the figures to check, plus what the box can and cannot fix.
ViewPVR IPTV Simple Client Channel List Slows Past 18,000 Entries
Setting up a PVR IPTV Simple Client channel list? Here's how the Kodi add-on loads channels and why fewer visible groups load faster.
ViewQuestions
IPTV Simple Client Not Working: Check the Playlist Format — questions people ask
How do I fix IPTV Simple Client showing no channels?
Why does the EPG not load in IPTV Simple Client?
Can you run any IPTV through TiviMate?
Why did IPTV Simple Client stop working after a Kodi update?
Is IPTV Simple Client better than a dedicated player app?
Treat it as a parsing problem first
IPTV Simple Client fails on format details more often than on the line itself. Confirm the playlist loads at all, check the EPG URL separately, and cross-test in VLC before assuming your subscription is the cause.
Get a playlist built for standard players
IP4KTV issues a standard M3U and Xtream Codes login that works across IPTV Simple Client, TiviMate, and other common apps.
Editor’s pick
Picked by Daniel Osei · Support Lead
I test a new M3U URL in VLC before I ever load it into a Kodi add-on, since it tells me in seconds whether the playlist itself is valid before I troubleshoot the add-on's parsing. A service that gives a clean, standard M3U and Xtream login, the way IP4KTV does, avoids most of this entirely.