How to set up IPTV on Kodi

Kodi is a media centre, not a streaming service. It plays what you give it and organises the result. For IPTV that means Kodi supplies the interface and the guide, and your provider supplies the streams; neither half is useful without the other.

The component that bridges the two is PVR IPTV Simple Client, an add-on shipped with Kodi itself. You do not need a third-party repository to install it, and if a guide tells you to add an unofficial repository to get IPTV working on Kodi, close the guide. That instruction has nothing to do with playing your own subscription.

What Kodi does not do is make a weak stream stronger. If channels buffer in your provider's own app they will buffer in Kodi, usually slightly worse, because Kodi's generic client cannot use the platform-specific tuning a native app can.

Two addresses and, in most cases, a set of credentials. The first is an M3U playlist address that resolves to your channel lineup. The second is an XMLTV guide address that supplies programme data. Providers issue both, usually in the welcome message or from the account dashboard.

If your provider only offers a native app and will not issue a playlist address, Kodi is not an option with that service and no amount of configuration will change it. Ask before subscribing if Kodi is a requirement for you.

It is worth understanding what a playlist address is before you paste it anywhere: it is a live authenticated link to your account. Anyone holding it can use your subscription, which is why sharing it and pasting it into public troubleshooting threads are both worse ideas than they look. The trade-offs between playlists and native apps are covered in more depth in the M3U guide.

Open Kodi and go to Add-ons, then My add-ons, then PVR clients, and select PVR IPTV Simple Client. If it shows as disabled, enable it — on most installs it is present but off.

Choose Configure. On the General tab, set the location to Remote path and paste your M3U playlist address into the M3U play list URL field. Leave the refresh interval at its default unless your provider tells you otherwise.

Move to the EPG Settings tab, set that location to Remote path as well, and paste your XMLTV guide address into the XMLTV URL field. If your provider supplies a time-shift or offset value, enter it here; otherwise leave it at zero.

Confirm with OK, then fully close and reopen Kodi. This step is not optional — the TV entry does not appear in the main menu until Kodi restarts with an enabled PVR client, and it is the single most common reason people conclude the setup failed when it actually worked.

After the restart, the TV section appears and channels load first. Guide data arrives afterwards and is slower, because Kodi downloads and parses the entire XMLTV file before it can display anything. On a large lineup that is a genuinely big file and several minutes is normal on modest hardware.

If channels play but the guide stays empty after ten minutes, the problem is almost always one of three things: the XMLTV address is wrong, the location was left as Local path instead of Remote path, or the guide file uses channel identifiers that do not match the ones in the playlist. The third is your provider's to fix and cannot be worked around in Kodi's settings.

If programmes appear but sit in the wrong time slots, that is the offset value, not a broken guide. Adjust the time-shift setting until the current programme aligns with what is actually playing. Kodi's EPG behaviour and the wider question of how guides are assembled are covered in the EPG guide.

No TV entry in the menu: the client is disabled, or Kodi has not been restarted since it was enabled. Both are settled in under a minute.

Channels listed but none play: usually an expired or mistyped playlist address. Paste the address into a browser — if it does not return a playlist file, the problem is upstream of Kodi and belongs with your provider.

Everything buffers in Kodi but plays in another app: check whether hardware acceleration is on under Settings, Player, Videos. On low-powered hardware a software decode of a 4K stream will stutter no matter how good the connection is.

It worked yesterday and not today: providers rotate playlist addresses periodically, and some rotate them on every password change. Fetch the current one from your account rather than assuming the old link is permanent.

Kodi's advantages are real. It is free, it runs on nearly everything, it puts live channels alongside your own media library in one interface, and it is deeply customisable if that is something you enjoy.

Its disadvantages are also real, and they are the ones you feel daily. Channel switching is slower because the generic client keeps a weaker cache. Reconnection after a dropped stream is less graceful. Guide loading is heavier. And when something breaks, the failure could be Kodi, the add-on, the skin, the platform build or the stream, which makes support slower for everyone including you.

The honest recommendation: if Kodi is already your media centre and live channels are an addition to it, this setup is worth doing. If you are installing Kodi solely to watch IPTV, install your provider's app instead — you are adding a layer whose only function is to make the same streams slightly worse.

Search for Kodi and IPTV together and you will find pre-configured builds and repositories promising thousands of channels at no cost. These are not what this guide describes and they are not a way to use a subscription you paid for.

They carry two distinct problems. The obvious one is that unlicensed streams disappear without notice and take your setup with them. The less obvious and more serious one is that a build is arbitrary code with full access to your device, installed from a source with no accountability, onto hardware sitting inside your home network.

Official Kodi from the Kodi Foundation, plus the bundled PVR client, plus a playlist from a provider you pay, is the entire supported configuration. Everything beyond that is someone else's software running on your television for reasons they have not explained.