Short answer: Kodi plays IPTV through one official add-on — PVR IPTV Simple Client, which ships with Kodi and needs no third-party repository. Enable it, paste your M3U playlist URL, add an EPG URL if your provider supplies one, then restart Kodi. The step that stops most people isn't in any menu: several settings stay hidden until you change the settings level to Expert by clicking the gear icon at the bottom of the settings screen. Kodi is free, open source and runs on almost everything — and the "builds" and add-on bundles advertised alongside it are neither official nor safe.
At a glance
Kodi IPTV in short
| Add-on | PVR IPTV Simple Client (built in) |
| You need | An M3U URL, optionally an EPG URL |
| The trap | Settings level must be set to Expert |
| Cost | Free, open source |
| Avoid | "Builds", third-party repos, stream add-ons |
What Kodi is, and isn't
Kodi is a free, open-source media centre from the non-profit XBMC Foundation. It organises your own media and, through add-ons, plays other sources — including IPTV playlists.
It contains no channels and no content of its own. Everything you watch comes from something you supply: your files, or your provider's playlist. That distinction matters, because a great deal of what's written about "Kodi IPTV" is really about unofficial add-ons that scrape streams from elsewhere, which is a different thing entirely and not what this page covers.
Kodi runs on Windows, macOS, Linux, Android, Android TV, Fire TV and Raspberry Pi. Not on Roku, and on iOS only with difficulty.
Setting it up, step by step
You'll need your M3U playlist URL from your provider, and an EPG URL if they supply one separately.
- Open Settings — the gear icon on the home screen.
- Set the settings level to Expert. Click the gear or cog at the bottom-left of the settings screen repeatedly until it reads "Expert". Skip this and half the options below won't be visible — this single step causes most of the confusion around Kodi.
- Go to Add-ons → My add-ons → PVR clients → PVR IPTV Simple Client, and enable it if it isn't already.
- Open its Configure screen. Under General, set the location to Remote path and paste your M3U URL. If you have a file instead, choose Local path and browse to it.
- Add your EPG. On the EPG tab, set the XMLTV URL your provider gave you.
- Restart Kodi. The channel list won't populate properly until you do.
- Open TV from the home screen. Your channels should be listed, with the guide filling in over the next minute or two.
A large playlist can take a while to load the first time. Let it finish before changing anything.
Getting the programme guide right
The guide is where most Kodi IPTV setups feel broken, and it's usually one of three things.
Wrong or missing URL. The EPG is a separate address from the playlist. If your provider hasn't given you one, the channel list works but the guide stays empty.
Times shifted by hours. The guide data is in a different time zone from yours. PVR IPTV Simple Client has a time-shift setting in its EPG tab — adjust it rather than assuming the data is wrong.
Channels not matching their guide. Kodi matches channels to guide entries by their identifiers in the playlist. If your provider's playlist has missing or inconsistent identifiers, some channels show no programme information. That's a provider-side problem, and worth raising with them.
Also check how far back Kodi keeps guide data — under Settings → TV → Guide, "Days to display" controls how much you see.
Settings worth changing
Start channels on last watched. Under Settings → TV → Playback, so Kodi resumes where you left off.
Channel switching mode. Also under Playback — a small change that makes zapping feel much faster.
Hide channel groups you don't watch. Under TV → Channels, which is the difference between a usable list and scrolling past hundreds of entries.
Enable hardware acceleration. Under Player → Videos. On low-powered boxes it's the difference between smooth and stuttering; if you get audio but no picture, try switching it off.
Increase the cache if you see frequent brief pauses. It's an advanced setting, and worth trying only after ruling out the network.
Common problems
"No PVR add-ons enabled." The client isn't switched on. Add-ons → My add-ons → PVR clients → enable.
Channels listed but won't play. Test the same stream in VLC. If it fails there too, the problem is the stream or your subscription, not Kodi.
Nothing appears after adding the playlist. Restart Kodi. Almost every first-time setup needs it.
Guide empty. See the EPG section above.
Buffering during live sport. Network first, then device. Use ethernet where you can, and check whether the same stream is fine on a phone over mobile data.
Everything broke after an update. Kodi's major versions sometimes change add-on compatibility. Check the add-on has updated too before assuming your setup is at fault.
Why to avoid builds and third-party repos
Search for Kodi and you'll be offered "builds" — pre-configured bundles promising thousands of live channels and every film. They're worth understanding clearly.
A build replaces your Kodi configuration wholesale with someone else's, including add-ons from anonymous sources that have full access to your system and your network. Many of those add-ons exist to scrape unlicensed streams; they break constantly, and the people distributing them have been the target of enforcement action.
The Kodi project itself has been consistent about this: it doesn't endorse builds or piracy add-ons, and problems caused by them aren't supported.
The safe setup is the boring one — official Kodi from kodi.tv or your platform's store, the built-in PVR client, and a playlist from a service you pay. How to find one worth paying.
Kodi or a dedicated player?
Choose Kodi if you want maximum control, you're running it on a PC or Raspberry Pi, you want your own media library and live TV in one interface, or you like configuring things. It's free and it runs everywhere.
Choose a dedicated player — TiviMate on Android TV and Fire TV, Smart IPTV on Samsung and LG — if you just want live TV to work with a good guide and minimal setup. They're built for this one job, and it shows. The full player comparison.
Plenty of people run both: Kodi for their own library, a dedicated player for channels.
Frequently asked questions
How do I add IPTV to Kodi? Enable PVR IPTV Simple Client, paste your M3U URL in its settings, add an EPG URL if you have one, and restart Kodi.
Is Kodi legal? Yes. It's open-source software from a non-profit foundation. What some third-party add-ons do with it is another matter.
Does Kodi include channels? No. You supply a playlist from a provider.
Why can't I see the settings described in guides? The settings level is too low. Click the cog at the bottom of the settings screen until it reads Expert.
Why is my guide empty or wrong? Missing EPG URL, a time-zone offset, or channel identifiers that don't match between playlist and guide.
Should I install a Kodi build? No. Builds replace your setup with unvetted add-ons from anonymous sources and aren't supported by the Kodi project.
Menu locations vary slightly between Kodi versions and skins. Download Kodi only from kodi.tv or your platform's official app store.