What Kodi is, and what it is not
Kodi is free, open-source media centre software. It plays files you already have, organises them with artwork and metadata, and runs on nearly everything — Windows, macOS, Linux, Android, Fire TV and more.
What it is not is a service. Kodi carries no channels and no content of its own; it is an empty shell until you point it at something. Live television arrives through a built-in add-on that reads a playlist you supply, which is what the rest of this guide covers.
Because Kodi is neutral software, what you watch through it is decided entirely by the source you configure. Whether that content is properly licensed depends on the provider supplying it and on the content licensing rules in your own country — our guide on what to check before you subscribe covers how to assess that. This guide uses only the official add-on that ships with Kodi.
When Kodi makes sense for this
Be honest with yourself about which situation you are in, because it changes the answer completely.
If you already use Kodi daily for your own films and music, adding live channels to the same interface is genuinely convenient. One remote, one layout, one place to look.
If you do not use Kodi and are installing it purely to watch IPTV, you are choosing the most complicated route available. A dedicated player will be quicker to set up, faster to change channels and better at handling a large list — our comparison of the main players covers the alternatives.
What the PVR IPTV Simple Client does
It is the official add-on that turns a playlist into Kodi’s TV section. It ships with Kodi rather than being something you hunt for, and it needs two things from you: the location of your playlist, and optionally the address of a guide source.
Once configured it populates Kodi’s TV area with channels and programme data, so live television appears alongside your own library rather than in a separate app.
It is deliberately simple. It reads a list and plays from it; it does not manage accounts, catch-up archives or the on-demand sections that an Xtream Codes login exposes in other players.
Setting it up
1. Find the add-on
Open the add-on browser from the settings area, look under the PVR clients category, and select PVR IPTV Simple Client. On most builds it is already present and simply needs enabling and configuring rather than installing.
2. Point it at your playlist
Open its configuration and choose whether your playlist is a remote address or a local file. A remote M3U address is the better option wherever your provider offers one, because Kodi can then refresh it on its own — our guide on what an M3U URL is covers the format.
Paste the address exactly as you were sent it. This is the field most often entered slightly wrong, and a nearly-right address fails identically to a completely wrong one.
3. Add a guide source
In the EPG section, enter the guide address your provider supplied. Without it you get channels with no programme information, which makes live television considerably less useful — our guide on what an EPG is explains where that data comes from.
4. Enable it and restart
Make sure the add-on is enabled, then restart Kodi completely. It reads the playlist on startup, so a restart is not optional the way it might be elsewhere.
The first load of a large list takes a while, and Kodi shows less progress than most players do. Let it finish before deciding something has failed.
Xtream Codes and Kodi
Worth setting expectations here, because it is a common disappointment.
The Simple Client is built around M3U playlists. It does not speak the Xtream Codes API the way IPTV Smarters Pro or TiviMate do, so you do not get the tidy separation of live channels, films and series that an Xtream login provides elsewhere.
Most providers issue an M3U address alongside Xtream credentials, and that is what you use here. Our comparison of Xtream Codes and M3U covers what you give up by taking the playlist route.
Where Kodi struggles with live television
- Channel changing is slower than in players built for live TV
- Very large lists make the guide sluggish, particularly on low-powered hardware
- Kodi uses more memory than a dedicated player, which matters on a small stick
- Favourites and channel ordering are more awkward to manage
- A guide that fails to match channels is harder to correct by hand
None of these makes it unusable, and on a capable machine most of them barely register. On a cheap streaming stick with a very large channel list they add up quickly — our guide on why changing channels feels slow covers what is happening underneath.
If it does not work
Work in this order. If no channels appear at all, the playlist address is the first suspect: re-enter it by hand and restart Kodi rather than just reloading the add-on.
If channels appear but will not play, test the same playlist somewhere else — VLC is ideal for this, because it takes an M3U address in seconds and tells you immediately whether the problem is Kodi or the source.
If channels play but the guide is empty, that is the EPG address rather than the playlist. Our guide on an EPG that will not load works through it, and app-level fixes covers the rest.
Should you use it?
Use Kodi for IPTV if it is already your media centre and you want one interface for everything. The Simple Client is reliable, it is official, and it does the job.
Choose a dedicated player if live television is the main event. TiviMate is faster and far better at a large channel list on Android devices; IPTV Smarters Pro covers more platforms and handles on-demand content properly.
And if you are troubleshooting rather than settling in, the general setup guide covers the steps that are the same whichever route you take.
Frequently asked questions
Can Kodi play IPTV?
Yes, through the PVR IPTV Simple Client, an official add-on that ships with Kodi. You give it an M3U playlist address and optionally a guide address, and live channels appear in Kodi’s TV section alongside your own library.
Does Kodi work with Xtream Codes logins?
The Simple Client is built around M3U playlists rather than the Xtream Codes API, so you do not get the separation of live, films and series that other players show. Most providers issue an M3U address alongside Xtream credentials, and that is what you use.
Do I need to restart Kodi after adding a playlist?
Yes. The add-on reads the playlist when Kodi starts, so a full restart is required rather than optional. The first load of a large list also takes longer than you might expect.
Is Kodi legal?
Kodi itself is free, open-source media software and is neutral about what you point it at. What matters is the source you configure: whether that content is properly licensed depends on the provider and on the rules in your own country.
Is Kodi better than a dedicated IPTV player?
For live television alone, generally not — channel changing is slower and large lists are heavier. It is a good choice if you already use Kodi for your own media and want everything in one interface.