...

Nviewx Guide

Find quick answers, helpful guides, and support resources to make your streaming experience smooth. Browse our Help Center.

IPTV on Kodi setup walkthrough and key settings for 2026

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.

IPTV on Kodi setup walkthrough and key settings for 2026
Setting up IPTV on Kodi with the PVR IPTV Simple Client add-on.

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.

Where each IPTV link goes in the Kodi PVR IPTV Simple Client settings
Each piece of provider information has exactly one home in the add-on’s settings.

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.

Kodi compared with a dedicated IPTV player for live TV, media, zapping speed and recording
Kodi earns its place when live TV sits alongside a local media library.

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

Win Unlimited Gifts & Rewards

Add unlimited extra free months to your subscription with just one click

Share with Your Friends & Family

Invite & Earn: Get 1 Month Free for Every Friend You Refer

Seraphinite AcceleratorOptimized by Seraphinite Accelerator
Turns on site high speed to be attractive for people and search engines.