IPTV on Kodi: Setup Walkthrough and Key Settings (2026)
Running IPTV on Kodi comes down to one add-on: PVR IPTV Simple Client. You install it from the official repository, paste your provider’s M3U link into one field, paste the XMLTV guide link into another, and Kodi turns into a live TV box with a proper channel grid. The whole thing takes about ten minutes.
What most walkthroughs leave out is the part that decides whether the setup still works next month. Kodi caches your playlist by default, so when your provider adds or renumbers channels, nothing changes on screen until you go back in and force it. There is a setting for that, it is off out of the box, and it is the difference between “Kodi is great” and “Kodi keeps breaking.”
This guide covers the install, the exact fields (with the labels as they appear in the add-on), the settings worth changing, the ones worth leaving alone, and an honest look at when Kodi is the wrong tool for the job.

What you need before you open Kodi
Three things, and two of them come from your provider. If you are missing either link, stop here and ask for them — there is no way to guess them.
| What | Looks like | Where it comes from |
|---|---|---|
| Kodi 20 or newer | Kodi 21.3 “Omega” is the current stable build | Your device’s app store, or the official Kodi download page |
| An M3U playlist URL | http://server:port/get.php?username=...&password=...&type=m3u_plus | Your provider’s welcome email or account panel |
| An XMLTV (EPG) URL | http://server:port/xmltv.php?username=...&password=... | Same place. Optional, but without it you get no TV guide |
If those links mean nothing to you yet, our explainer on what an M3U playlist is unpacks the format in a couple of minutes — the M3U format long predates IPTV and is really just a text list of stream addresses. On the guide side, what an IPTV EPG is covers where that data comes from. Worth a skim first — almost every Kodi problem later turns out to be a playlist or guide problem, not a Kodi problem.
Kodi itself is free, open source, and maintained by the non-profit Kodi Foundation. It ships with no channels, no content, and no subscription. It is a shell that plays whatever you point it at, which is exactly why it works so well as an IPTV front end.
How to set up IPTV on Kodi, step by step
Menu names shift slightly between skins and Kodi versions, but the path below matches a stock Kodi 21 install. Do these in order — skipping to the M3U field before the add-on is installed is the single most common cause of “I can’t find the settings.”
Step 1: Install PVR IPTV Simple Client
From the Kodi home screen, go to Settings (the cog) → Add-ons → Install from repository → Kodi Add-on repository → PVR clients → PVR IPTV Simple Client → Install. Accept the dependency prompt if one appears.
This is the official add-on, shipped in Kodi’s own repository, not a third-party build. You never need to add an unknown repository or enable unknown sources for it — if a guide tells you to, close that guide.
Step 2: Point the add-on at your M3U playlist
Go back to Settings → Add-ons → My add-ons → PVR clients → PVR IPTV Simple Client → Configure. On the General section:
- Set Location to Remote path. (Use Local path only if you saved a playlist file to the device.)
- Paste your playlist link into M3U play list URL.
Paste it — do not retype it. These URLs carry your username and password as query parameters, and one wrong character produces an empty channel list with no error message. If your provider gave you Xtream Codes credentials instead of a link, our comparison of M3U versus Xtream Codes shows how to build the M3U URL from a host, username and password.
Step 3: Add the TV guide
Still in Configure, open the EPG section. Set Location to Remote path and paste your guide link into XMLTV URL. Leave EPG time shift at zero for now; you only touch it if the guide loads but every programme sits at the wrong hour.
One useful toggle lives here: Ignore Case for EPG Channel IDs. Providers are inconsistent about capitalisation in their channel IDs, and turning this on fixes a surprising share of “half my channels have a guide and half say No Information” complaints. Guide data travels in the XMLTV format, and the match between playlist and guide happens on a per-channel ID, which is why one stray capital letter can break a row.
Step 4: Turn on auto refresh
Still on the General section, find Auto refresh mode. Out of the box it is set to Disabled, which means Kodi reads your playlist once, caches it, and keeps showing that snapshot indefinitely.
Set it to Once per day and pick a Refresh hour (24h) when nobody is watching — 4 or 5 in the morning is ideal. If your provider changes the line-up often, Repeated refresh with a Refresh interval of 60 minutes works too, though it hits the server more than most setups need. Note that enabling auto refresh disables local caching, so a slow playlist takes a moment longer to load on startup. That trade is almost always worth it.
This one setting prevents the most common Kodi complaint on forums: new channels the provider added weeks ago that simply never show up.
Step 5: Save, restart, and clear the cache if needed
Click OK to save. Restart Kodi. On relaunch it downloads the playlist and guide in the background, and a TV entry appears on the home menu with your channels under TV → Channels.
If channels or guide data look stale after a settings change, clear the relevant cache rather than reinstalling anything. Per the add-on’s own documentation, guide changes need Settings → PVR & Live TV → Guide → Clear cache, and channel changes need Settings → PVR & Live TV → General → Clear cache. That pair of menu paths solves a huge share of the problems people reinstall Kodi over.

The settings worth changing (and the ones to leave alone)
PVR IPTV Simple Client hides most of its options behind a settings level selector — Basic, Standard, Advanced and Expert. If a setting below is missing on your screen, raise the level inside the add-on’s settings dialog. Here is what earns its place.
| Setting | Where | What it fixes |
|---|---|---|
| Auto refresh mode | General | New channels never appearing. Set to Once per day. |
| Only number by channel order in M3U | General | Chaotic channel numbers. Ignores provider numbering and counts from your Start channel number. |
| Only load TV channels in groups + TV group mode | Groups | A 12,000-channel list that takes a minute to load. Pick Some groups and name up to five you actually watch. |
| EPG time shift | EPG | A guide that is right but offset by whole hours. Range is -12 to +14 hours. |
| Use inputstream.adaptive for m3u8 (HLS) streams | Advanced | Slow channel switching and stutter on HLS streams. Try it if your provider serves .m3u8; leave it off for plain MPEG-TS. |
| Enable catchup | Catchup | Playing back programmes that already aired — only if your playlist carries catchup tags. |
The group filter deserves special mention. Providers routinely ship playlists with tens of thousands of entries, and Kodi loads every one into memory before the TV menu opens. Restricting yourself to five groups can cut a 40-second startup to under five. If your library feels sluggish for other reasons, our notes on how IPTV apps and players differ explain where the load actually falls.
Leave the Media, Timeshift and multicast relay sections alone unless you have a specific reason. Timeshift in particular needs the separate inputstream.ffmpegdirect add-on to do anything, and switching it on without that dependency just produces failures that look like stream problems.
Kodi and Xtream Codes: the honest answer
There is no Xtream Codes login screen in PVR IPTV Simple Client. No host field, no username field, no password field. Every guide promising one is describing a different app.
What you do is convert those three credentials into an M3U URL — host, port, username, password assembled into a single link — and paste that. The add-on does have an Xtream codes option, but it lives under Channels support catchup using mode in the Catchup section and only governs how catchup URLs get built. It is not a login.
This trips up a lot of people moving over from a dedicated player. If your provider only gave you credentials, our guide to what Xtream Codes are shows the exact URL pattern, and the general IPTV setup guide covers the same conversion for other apps.
When Kodi is the wrong choice
Kodi is genuinely excellent if you want one interface for local media and live TV, if you like tinkering, or if you are on a platform where the good IPTV players do not exist. It is a poor choice if you just want live TV to work.
| If you want… | Kodi | A dedicated IPTV player |
|---|---|---|
| Live TV only | Works, but more setup than it needs | Faster: paste credentials, done |
| Local films plus live TV in one place | The reason to use Kodi | Not designed for it |
| Fast channel surfing | Slower zapping, heavier menus | Built for it |
| Recording and catchup | Possible, needs extra add-ons | Usually built in |
| Someone else in the house to use it | Steep learning curve | Simple channel list |
If that table is nudging you toward a purpose-built app, the head-to-head on TiviMate versus IPTV Smarters is the fastest way to choose one, and our platform picks cover the best IPTV players for Firestick, Android TV and Google TV, and Apple TV. Nothing stops you keeping Kodi installed alongside one of them.

Common problems and the fix that usually works
| What you see | Usual cause | Fix |
|---|---|---|
| No TV entry on the home screen | The add-on is installed but not enabled, or no channels loaded | Enable it under My add-ons, confirm the M3U URL, restart Kodi |
| Channel list is completely empty | Bad or expired playlist URL, or the connection limit is maxed | Open the same URL in a browser. If it downloads a file, the link is fine — see connection limit fixes |
| Channels load, guide says “No Information” | Channel IDs in the playlist do not match the guide file | Turn on Ignore Case for EPG Channel IDs, then clear the guide cache — more in EPG not showing |
| Guide is correct but hours are wrong | Time zone offset in the guide file | Adjust EPG time shift by the number of hours you are out |
| Everything buffers, especially in the evening | Network or provider load, rarely Kodi itself | Test the same stream in another player first — see peak-hour buffering and speed requirements |
| New channels never appear | The cached playlist, with auto refresh disabled | Set Auto refresh mode to Once per day and clear the channel cache once |
One diagnostic habit saves hours: before blaming Kodi, play the same channel URL in a second player. If it stutters there too, the problem is upstream — your connection, your DNS, or your provider — and no Kodi setting will rescue it. If it plays cleanly elsewhere, then it is worth digging through the add-on settings. Our buffering troubleshooting guide walks the same logic in more detail.
A note on what you point Kodi at
Kodi is legal, open source software with no content of its own. The legality of a setup depends entirely on the service supplying the streams — a properly licensed provider is fine, an unlicensed one is not, and the software in the middle does not change that. Our overview of where IPTV stands legally covers the distinction, and how to choose a provider covers the signs of a service worth paying for. The Kodi project itself takes a firm public line against add-ons built for piracy, which is worth knowing before you install anything from outside the official repository.
Frequently asked questions
Is PVR IPTV Simple Client still the right add-on in 2026?
Yes. It remains the only PVR client that takes an IPTV signal directly into Kodi without a separate backend server, it ships in Kodi’s official repository, and it is actively maintained on the Kodi project’s own GitHub. Anything else you see recommended is either a wrapper around it or a third-party build you should avoid.
Can I load two different IPTV playlists into Kodi at once?
Yes, from Kodi 20 (Nexus) onward. In the add-on’s Configure screen choose Add add-on configuration to create a second instance with its own M3U and XMLTV pair. Each behaves as an independent set of channels, which is handy if you run one subscription for live TV and another for a second household device.
Why do my channel numbers not match my provider’s?
Kodi uses the tvg-chno value from the playlist when Kodi’s own Use backend channel numbers option is on. If your provider omits those tags, numbering falls back to playlist order starting at Start channel number. Switching on Only number by channel order in M3U ignores provider numbers entirely and gives you a clean sequence.
Does Kodi need a VPN for IPTV?
Not for the software to function. Some people use one for privacy or because their connection throttles video, and some providers behave better through one. It is a separate decision from the Kodi setup itself — we cover when it helps in our VPN guide.
My playlist loads but nothing plays. Is that a Kodi problem?
Usually not. A playlist that loads proves your credentials and URL are correct, which means the failure is at playback. Test the same channel in another app: if it fails there too, it is the stream or your connection. If it only fails in Kodi, try switching Use inputstream.adaptive for m3u8 (HLS) streams on or off — that single toggle resolves a good share of “loads but won’t play” reports.
Related guides
- What is an M3U playlist? — the file format behind every IPTV setup
- What is an IPTV EPG? — how the TV guide is built and why it breaks
- M3U vs Xtream Codes — which login format to ask your provider for
- TiviMate vs IPTV Smarters — if a dedicated player suits you better
- Best Android TV box for IPTV — hardware that runs Kodi well
- How to set up IPTV — the device-agnostic version of this walkthrough





