Key Takeaways
- Kodi is the player, not the service: Kodi plays live TV through a PVR add-on. It does not include channels, so you need an M3U link from a provider.
- One add-on does the job: PVR IPTV Simple Client reads an M3U playlist and an optional XMLTV guide. You do not need a third-party repository or a “build.”
- Setup path: Settings, Add-ons, My add-ons, PVR clients, PVR IPTV Simple Client, Configure. Add your M3U URL, then your EPG URL, then restart.
- Xtream logins do not work directly: The add-on takes M3U links. Use the M3U link your provider generates from your Xtream account.
- Use stable Kodi: Kodi 22 “Piers” reached release candidate 1 on October 10, 2026. Kodi recommends stable releases for normal users, so Kodi 21 “Omega” is the safer choice today.
- Firestick needs care: Kodi is sideloaded on Fire TV, and newer Vega OS sticks block sideloading.
- Avoid builds and unknown repos: They are a common source of malware, and the content they push is often unlicensed.
Searching for “Kodi IPTV” usually leads to a confusing mix of setup guides, “all-in-one builds” and subscription ads. The real process is short. Kodi has one official add-on for IPTV, and it needs only two things from you: a playlist link and, if you want a TV guide, a guide link.
This guide walks through each step, covers errors and explains the risks of Kodi add-ons and builds. It is based on the add-on’s official repository, Kodi release news and independent guides as of November 2026. We did not test every device, so menu names may differ slightly on your platform.
What Is Kodi IPTV?
Kodi is a free, open-source media center. It plays local videos and music, and it can also play live IPTV through a PVR client add-on. The standard one is PVR IPTV Simple Client, which reads an M3U playlist and an XMLTV program guide.
Kodi does not supply channels. For the basics of how IPTV works, start with our overview, and read our guide to choosing an IPTV service if you do not have a source yet.
What You Need Before You Start
- A device that can run Kodi, such as a PC, Android TV box, Firestick or Raspberry Pi.
- An M3U playlist URL from your provider.
- An XMLTV guide URL, if your provider gives one.
- A stable connection, ideally wired. Our guide to the M3U playlist explains what that link contains.
If your provider only gives you a username, password and server address, ask for the M3U link or check how it works in our guide to M3U vs MAC address logins.
Which Kodi Version Should You Use?
Use the latest stable release, Kodi 21 “Omega.” Version 21.3 is the most recent stable build we found. Kodi 22 “Piers” is close, but it is still a pre-release.
BetaNews reports that Kodi 22 RC 1 arrived on October 10, 2026, and that the developers called it the final state they want to ship. No final release date has been announced, and the Kodi download page recommends stable releases for normal users. When Kodi 22 becomes stable, the IPTV steps below should stay the same.
How to Install Kodi
Download Kodi only from the official website, kodi.tv/download. The site offers versions for Windows, macOS, Linux, Android, iOS, tvOS, Raspberry Pi and LG webOS. Avoid third-party download sites, which often bundle extras.
| Device | How to install |
|---|---|
| Windows, macOS, Linux | Download the installer from the official site |
| Android phone or Android TV | Install from Google Play or download the Android build |
| Firestick and Fire TV | Sideload with the Downloader app |
| iPhone, iPad, Apple TV | Use the version offered on the Kodi download page |
| Raspberry Pi | Use a Kodi-focused operating system or the Linux build |
Installing Kodi on a Firestick
On Fire OS devices, enable apps from unknown sources in Developer Options. Install the Downloader app, open it and go to the Kodi download page. In its Kodi 21.3 guide, BetaNews chose the Android ARMV7A (32-bit) build for a Firestick. Use the build that Kodi’s page recommends for your device. For more on setup, see our guide to IPTV on Firestick.
Check your model before you start. Amazon’s newer sticks run Vega OS. BGR reports that these models block sideloading, so you cannot install Kodi that way. Reports also say Amazon has started blocking apps it identifies as piracy tools on Fire TV, which is another reason to use only official Kodi software.
How to Set Up IPTV on Kodi With PVR IPTV Simple Client
These steps work on Kodi 20 and later. They match the add-on’s official repository, kodi-pvr on GitHub.
- Open Kodi and select the Settings gear icon.
- Go to Add-ons, then My add-ons, then PVR clients.
- Select PVR IPTV Simple Client. If it is not listed, install it from Kodi’s official add-on repository.
- Choose Configure. Since Kodi 20, you can create several M3U and XMLTV pairs, so select Add add-on configuration if prompted.
- On the General tab, set the location to the remote path (internet address).
- Paste your M3U play list URL.
- Open the EPG Settings tab and paste your XMLTV URL.
- Select OK and enable the add-on if Kodi asks.
- Restart Kodi. The channel list may not fill properly until you do.
- Open TV on the home screen to see channels and the guide.
If an option is missing, change the add-on’s settings level to Expert. From Kodi 19, you can do this from within the add-on’s settings.
Does Kodi Support Xtream Codes?
PVR IPTV Simple Client takes M3U links. It does not log in with a server URL, username and password. Xtream-based providers can usually generate an M3U link from your account, so ask yours for one. The add-on can build an Xtream-style catch-up URL from a channel URL, but that is separate from signing in.
If you prefer a player that accepts Xtream details directly, see our guide to the best IPTV Smarters setup fixes and our IPTV player comparison.
Add Your TV Guide (EPG)
An XMLTV guide gives you program titles and schedules. The add-on supports gzip and XZ compressed XMLTV files, so you can paste a compressed guide link as is. Kodi loads guide data only when it needs it, which keeps a big guide from slowing every start.
If program times look wrong, use the add-on’s EPG time shift setting. Our explainer on catch-up TV covers the related feature that replays recent programs.
Use More Than One Playlist
Since Kodi 20, PVR IPTV Simple Client can hold several M3U and XMLTV pairs. In the add-on’s settings under Configure, choose Add add-on configuration to add another one. This helps if you keep a separate playlist for sports or another region, but keep the list small on low-power devices.
Catch-Up and Channel Logos
Catch-up works only if your provider supports it. The add-on reads catch-up tags from the M3U entries, and those tags override the add-on’s own catch-up settings. Logos can come from the M3U, the XMLTV file or both, depending on the logo setting you choose.
Kodi IPTV Troubleshooting
| Problem | Likely cause | What to try |
|---|---|---|
| Channel list is empty | Wrong URL, or Kodi was not restarted | Open the URL in a browser to confirm it downloads, then restart Kodi |
| No guide data | Wrong or unreachable XMLTV URL | Re-check the link, then go to PVR and Live TV, Guide, and use Clean data and Update now |
| Guide times are off | Time zone mismatch | Change the EPG time shift setting |
| Channel logos are missing | Logo source setting | Switch between M3U and XMLTV logo preferences |
| Catch-up does nothing | Provider does not support it, or tags are missing | Ask your provider, then check the catch-up settings |
| Settings are missing | Settings level is too low | Set the add-on’s settings level to Expert |
| Xtream login fails | The add-on does not accept Xtream logins | Use the M3U link from your provider instead |
| Add-on is not listed | Not installed on your platform | Install PVR IPTV Simple Client from the official repository |
For a stubborn playlist, try it in another player such as VLC to see whether the problem is the link or Kodi.
Kodi vs Other IPTV Players
Kodi is flexible but hands-on. A dedicated IPTV app is usually faster to set up.
| Player | Strength | Setup effort |
|---|---|---|
| Kodi | Free, open source and available on many platforms | Higher, because settings are manual |
| TiviMate | An interface built around live TV on Android-based devices | Low |
| IPTV Smarters | Direct Xtream login | Low |
| VLC | Simple playback of an M3U link | Low, with no guide integration |
Our guide to the best IPTV TiviMate options explains the TiviMate route in more detail. If you use an iPhone or iPad, see the IPTV player for iOS guide, and for Linux see the IPTV player for Linux guide.
Kodi Builds and Add-ons to Avoid
PVR IPTV Simple Client is built for Kodi and needs no outside repository. “Builds” and unknown repositories are different. They are bundles that install dozens of third-party add-ons at once, and many of them point to unlicensed streams.
They also carry real risks:
- Malware: Unknown repositories can hide harmful code.
- Account theft: Add-ons can capture logins you type into them.
- Broken installs: Builds often fail after a Kodi update.
- Legal exposure: Many add-ons link to unlicensed content.
Stick to the official Kodi build, the official add-on repository and a provider that can tell you where its content comes from.
Is Kodi IPTV Legal and Safe?
Kodi and PVR IPTV Simple Client are legal software. Whether what you watch is legal depends on your source. For licensed options, see our overview of legal IPTV services.
A VPN for IPTV can limit what your internet provider sees, but it does not change a source’s license status. Before you pay a provider, use a trial and read our guide to the IPTV free trial.
Kodi IPTV Pros and Cons
Pros
- Free and open source.
- Runs on many platforms.
- Supports XMLTV guides, multiple playlists and catch-up.
- No third-party repository needed for IPTV.
Cons
- Manual setup with several menus.
- No direct Xtream login.
- Sideloading is required on Fire TV, and Vega OS sticks block it.
- Builds and unofficial add-ons add risk.
- Large guides can slow low-power devices.
Kodi IPTV FAQ
-
How do I add IPTV to Kodi?
Enable PVR IPTV Simple Client, add your M3U URL in its settings, add an XMLTV URL for the guide if you have one, and restart Kodi.
-
Where is PVR IPTV Simple Client in Kodi?
Go to Settings, Add-ons, My add-ons, then PVR clients. If it is not listed, install it from the official add-on repository.
-
Does Kodi support Xtream Codes?
Not as a direct login. PVR IPTV Simple Client uses M3U links, so ask your provider for an M3U link generated from your account.
-
Is Kodi 22 stable yet?
Not as of November 2026. Kodi 22 “Piers” reached release candidate 1 on October 10, 2026, and Kodi recommends stable releases for normal users.
-
Why is my Kodi IPTV guide not showing?
The XMLTV URL may be wrong or unreachable. Check the link, then use Clean data and Update now in the PVR guide settings.
-
Can I use Kodi on a Firestick?
Yes, on Fire OS models, by sideloading with Downloader. Newer Fire TV sticks that run Vega OS block sideloading.
-
Is Kodi safe to use for IPTV?
Official Kodi and PVR IPTV Simple Client are safe to use. Avoid builds and unknown repositories, which are the main risk.
