Quick answer
To watch IPTV in Kodi, install the official PVR IPTV Simple Client add-on, set its M3U playlist to your provider's URL, add the XMLTV link for the guide, restart Kodi, and open TV from the main menu. Avoid third-party "builds" that promise free channels.
What you need
- Kodi installed on your device.
- Your M3U playlist URL — how to get it.
- Your EPG (XMLTV) link — what it is.
Set it up in 5 steps
Install PVR IPTV Simple Client
Kodi → Add-ons → Install from repository → Kodi Add-on repository → PVR clients → PVR IPTV Simple Client → Install. It is the official add-on maintained by the Kodi team.
Open its settings
Add-ons → My add-ons → PVR clients → PVR IPTV Simple Client → Configure.
Add your playlist
Under General, set Location to Remote path (Internet address) and paste your M3U URL in M3U playlist URL.
Add the guide
Under EPG, set Location to Remote path and paste your XMLTV link. Adjust the time shift if programmes are off by an hour.
Restart Kodi and open TV
Restart Kodi. A TV entry appears in the main menu with channels and a guide.
Settings worth changing
| Setting | Where | Why |
|---|---|---|
| Refresh playlist on start | Simple Client → General | Picks up new channels |
| EPG time shift | Simple Client → EPG | Fixes a guide that is an hour off |
| Channel logos | Simple Client → Channel logos | Uses tvg-logo from the M3U |
| Group channels | Settings → PVR & Live TV → Channels | Shows categories from group-title |
| Buffer | Advanced settings file (cache) | Smoother playback on slow links |
Skip the third-party builds
Many "Kodi IPTV builds" bundle add-ons that stream unlicensed channels, slow down your device and can carry malware. The official repository has everything you need for your own subscription.
Frequently asked questions
Is Kodi IPTV legal?
Kodi and the PVR IPTV Simple Client are legal, open-source software. What matters is the playlist you load. Avoid third-party "builds" and add-ons that promise free premium channels.
Does Kodi support Xtream Codes?
Not in the official Simple Client — use your M3U link (built from your Xtream details if needed). Some third-party add-ons add Xtream support; only use ones you trust.
Why are my channels empty after setup?
Restart Kodi after changing the add-on settings, check the M3U URL, and make sure the add-on is enabled under My add-ons → PVR clients.
Which devices run Kodi?
Android TV and boxes, Fire TV, Windows, Mac, Linux, Raspberry Pi, and iOS/Apple TV via sideloading.