Skip to content

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.

DO

Daniel Osei

Support Lead

fix · 8 min read · Updated 2026-08-08

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. 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. 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. 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. 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. 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. 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.

Questions

IPTV Simple Client Not Working: Check the Playlist Format — questions people ask

How do I fix IPTV Simple Client showing no channels?
Re-check the M3U playlist URL for typos or an expired token first, since a blank list almost always means the add-on couldn't parse anything from that address. Test the same URL in a browser or in VLC; if it downloads a valid playlist file there, the add-on's settings are the issue, most likely the URL was entered with extra spaces or the wrong protocol prefix.
Why does the EPG not load in IPTV Simple Client?
The guide uses a separate address from your channel playlist, and it needs its own valid XMLTV URL entered in the add-on's settings. Even with a correct URL, guide entries only populate if their channel ID field matches the ID used in your playlist exactly. Re-enter both fields carefully and give the add-on a few minutes to run its next scheduled guide update.
Can you run any IPTV through TiviMate?
TiviMate and IPTV Simple Client both accept a standard M3U playlist URL or Xtream Codes login, so most services work in either. If a playlist works in one but not the other, the fault is in how that specific app parses the file, not the service behind it, which is a useful way to isolate an add-on problem from a line problem.
Why did IPTV Simple Client stop working after a Kodi update?
Kodi updates occasionally change how add-ons load or handle their cached data, and PVR add-ons are affected more often than most because they hold a live connection open. Check that your installed version of the add-on matches what the current Kodi release supports, clear its cache, and re-enter your playlist URL rather than assuming your subscription changed. The timing, working right up until the update, is usually the clearest sign of what actually happened.
Is IPTV Simple Client better than a dedicated player app?
It depends on what you want. Running channels inside Kodi through IPTV Simple Client keeps everything in one interface alongside your other media, but a dedicated app like TiviMate or IPTV Smarters is usually more forgiving with malformed playlists and gives clearer error messages when something fails to parse. If you mainly want live channels without troubleshooting a media center, a dedicated app is often the simpler starting point.

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.

DO

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.

Need Help?