Kodi plays IPTV through PVR IPTV Simple Client, which ships with Kodi and only needs turning on. Go to Settings → Add-ons → My add-ons → PVR clients → PVR IPTV Simple Client → Configure, paste your M3U URL under General and your EPG URL under EPG Settings, then restart Kodi. The channels appear under TV in the main menu.
What you need to know
- Kodi was called XBMC until 2014, so XBMC guides describe the same software.
- PVR IPTV Simple Client is built into Kodi. There is nothing to download.
- It takes an M3U URL and an EPG URL, not an Xtream Codes login.
- You must restart Kodi after you set it up, or the TV menu does not appear.
- Kodi itself is free and legal. Its bad reputation comes from third-party add-ons.
- PVR IPTV Simple Client plays live TV but does not record.
How to set up IPTV on Kodi in 8 steps
Turn on PVR IPTV Simple Client, paste your M3U URL and EPG URL, then restart Kodi. It is often called the Kodi IPTV Simple Client, or the XBMC IPTV Simple Client from Kodi's old name, and the step everyone misses is the last one.
Open Settings
Select the cog icon on the Kodi home screen.
Go to Add-ons → My add-ons
This is the list of everything already installed, which includes the IPTV client.
Open PVR clients
Then choose PVR IPTV Simple Client. It is there by default, with nothing to download.
Enable it
If the button says Enable, press it before you go further. A disabled add-on can still be configured, which wastes ten minutes.
Choose Configure
Then open the General tab.
Set Location to Remote path and paste your M3U URL
Paste the full link, starting with http. Finding your playlist URL.
Open EPG Settings and paste your EPG URL
This is a different link from the playlist, and without it there is no guide. How EPG works.
Restart Kodi completely
Close it and open it again, instead of going back to the home screen. The channels appear under TV. Skipping this is the most common reason people think the setup failed.
Do you need an IPTV add-on for Kodi?
No. PVR IPTV Simple Client is the only add-on you need, and it is already installed. Kodi is an IPTV player as well as a media centre once that add-on has your playlist.
Third-party IPTV add-ons that come with their own channels are a different thing: they scrape streams from elsewhere, break often, and are behind Kodi's bad reputation. With your own subscription, you do not need them.
Is Kodi the right choice for IPTV?
Yes, if you already use Kodi or want one interface for your own media and live TV. No, if you only want live TV.
- Yes, if you already use Kodi for local films and music. Adding live TV to something you already run is the least effort.
- Yes, if you want one interface for your own media and your subscription.
- Yes on a dedicated box, such as a Raspberry Pi or a small PC wired to the TV and left on.
- No, if you only want live TV. TiviMate does it better, with a tenth of the setup.
- No, if you dislike maintenance. Kodi updates sometimes break add-on settings, and the fix is often in a forum thread.
- No on a Fire Stick as a first choice. It runs, but it is heavy, and a lighter player works better on that hardware.
What goes wrong with IPTV on Kodi?
Usually Kodi was not restarted after setup. The other causes are a missing EPG URL, a disabled add-on, and settings lost in an update.
| Symptom | Usually |
|---|---|
| No TV option in the menu | Kodi was not restarted after the setup |
| Channels but no guide | The EPG URL is missing, or the playlist URL was pasted twice |
| The add-on will not configure | It is disabled, so enable it first |
| Everything disappeared after an update | Set the add-on up again, because the settings did not survive |
Troubleshooting by symptom covers problems that are not Kodi's fault.
Is Kodi legal?
Yes. Kodi is free, open-source media player software with no content of its own. Its reputation is mostly undeserved.
What gave Kodi a bad name were third-party add-ons that scraped unlicensed streams. They have nothing to do with the Kodi project, or with PVR IPTV Simple Client, which plays a playlist you supply.
Using Kodi with a subscription you pay for is no different from using any other player. The legality guide covers where the line sits.
Frequently asked questions
How do I add IPTV to Kodi?
Go to Settings → Add-ons → My add-ons → PVR clients → PVR IPTV Simple Client → Configure. Set Location to Remote path, paste your M3U URL under General and your EPG URL under EPG Settings, then restart Kodi completely. The channels appear under TV.
What is PVR IPTV Simple Client?
The add-on Kodi uses to play IPTV playlists. It ships with Kodi, so there is nothing to install, and it only needs turning on and setting up. It takes an M3U playlist and an EPG URL and turns them into a live TV section with a guide.
I set it up but there is no TV option. What is wrong?
Kodi was not restarted. The add-on registers its channel list at startup, so the TV menu does not appear until you close Kodi completely and open it again.
Is there a DVR for Kodi with IPTV?
Not in PVR IPTV Simple Client, which plays but does not record. Recording in Kodi needs a separate backend such as TVHeadend, or use a player with recording built in, such as TiviMate Premium.
What is the best IPTV for Kodi?
Any service that gives you an M3U URL and an EPG URL works in Kodi. HakunaXTR supplies both, so you can test it in Kodi during the free trial.
Is Kodi better than IPTV Smarters or TiviMate?
No, it is different. Kodi is the right answer if you already use it for your own media and want one interface for everything. If you only want live TV, TiviMate gives a better result with far less setup, and IPTV Smarters is simpler again.