Kodi IPTV Setup: PVR IPTV Simple Client Guide

Kodi handles IPTV properly — live channels, a full programme guide, even recording — using a component that ships with it as standard. No third-party add-ons, no dodgy repositories, nothing to install from outside Kodi itself.
That last point matters, because Kodi's reputation has been shaped by add-ons that have nothing to do with the software. What we're covering here is the built-in, entirely legitimate way to watch an IPTV subscription in Kodi.
- IPTV works through PVR IPTV Simple Client, which is built into Kodi.
- You need two things: your M3U link and your EPG (XMLTV) URL.
- Kodi is free, open source and legal — the controversy is about third-party add-ons, not Kodi.
- It’s more setup than a dedicated IPTV app, but far more flexible.
Clearing up the Kodi reputation
Kodi is a free, open-source media centre from a non-profit foundation. It plays your files, organises your library, and — with the built-in PVR client — handles live TV. It ships with no content whatsoever.
Its association with piracy comes entirely from third-party add-ons that others built to stream unlicensed content, which the Kodi project itself has repeatedly and publicly opposed. Using Kodi with a legitimate IPTV subscription is no different from using any other player, and involves none of that ecosystem.
Everything below uses only what's already inside Kodi.
Setting up PVR IPTV Simple Client
The client is bundled but disabled by default:
- Open Kodi → Add-ons → My add-ons → PVR clients.
- Select PVR IPTV Simple Client and choose Enable.
- With it selected, choose Configure.
- Under General, set Location to Remote Path (Internet address).
- Paste your M3U playlist URL into the M3U play list URL field.
- Switch to the EPG Settings tab and paste your XMLTV EPG URL.
- Save, then restart Kodi.
That restart isn't optional — the PVR system only initialises properly on startup, and skipping it is the most common reason people think the setup failed. After restarting, a TV section appears on the home screen with your channels and guide.
After the restart, Kodi downloads and parses both your playlist and the guide data in the background. With a large channel list this genuinely takes a few minutes, and the TV section can look empty or half-populated while it works. Don’t start changing settings — make a cup of tea and check again. Most “Kodi IPTV isn’t working” posts are people interrupting a process that hadn’t finished.
Getting the guide right
Kodi's guide is excellent once populated, but it depends on your channels matching the EPG data. If channels appear with no programme information, the tvg-id tags in your playlist don't line up with the IDs in the XMLTV file — a provider-side mismatch rather than anything you've configured wrongly. Our EPG setup guide explains it, and our M3U file guide covers the tags themselves.
If times are wrong rather than missing, that's a timezone conversion issue — XMLTV stores everything in UTC.
Why choose Kodi over a dedicated IPTV app?
Honestly, most people shouldn't. But there are real reasons:
- You already use Kodi for local media and want everything in one interface.
- You want a unified library — films, music, photos and live TV together.
- You like customising. Kodi's skinning and configuration go far beyond any IPTV app.
- You want recording with a proper PVR back-end.
- You're on a platform where the better IPTV apps aren't available.
If none of those apply, a dedicated player is simpler and quicker. Our best IPTV player comparison covers them.
Where Kodi is more work
Being fair about the trade-off: Kodi asks more of you. There's more configuration, the restart requirement catches people out, and large playlists can feel slower to navigate than in an app built purely for live TV. TiViMate on Android hardware will feel snappier for pure channel-surfing — see our TiViMate guide.
Kodi's strength is breadth, not speed.
The usual reminder
Kodi is the interface. Whether your telly holds up at peak time comes down to the service feeding it — a well-configured Kodi setup pointed at an overloaded server still stutters. That's what a properly resourced IPTV subscription UK provides.
Frequently asked questions
How do I set up IPTV on Kodi?
Enable PVR IPTV Simple Client under Add-ons → PVR clients, configure it with your M3U URL and XMLTV EPG URL, then restart Kodi. A TV section appears with your channels.
What is PVR IPTV Simple Client?
The IPTV component built into Kodi. It reads an M3U playlist and XMLTV guide data to provide live TV inside Kodi's own interface.
Is Kodi IPTV legal?
Kodi is legal, free, open-source software with no content of its own. Legality depends entirely on the subscription you point it at, not on Kodi.
How do I add EPG to Kodi?
In PVR IPTV Simple Client's configuration, open the EPG Settings tab and enter your XMLTV EPG URL, then restart Kodi.
Is Kodi better than IPTV Smarters?
Different tools. Kodi is more flexible and unifies all your media; Smarters is simpler and faster to set up for live TV alone.