Kodi IPTV Player: Set Up the PVR IPTV Simple Client
Use Kodi as an IPTV player with the official PVR IPTV Simple Client, an M3U link and a guide link, and know when another player is simpler.
Kodi works as an IPTV player through one official add-on, the PVR IPTV Simple Client. Kodi and the add-on are both free, and the add-on installs from the official Kodi add-on repository inside the app. You give it an M3U link for the channels and, ideally, a guide link for the programme guide, and Kodi's TV section fills in. Neither Kodi nor the add-on includes any channels. They play a line you already have.
Key takeaways:
- Kodi plays IPTV through the PVR IPTV Simple Client, installed from the official Kodi add-on repository.
- The add-on takes an M3U link for channels and an XMLTV link for the guide. Ask your provider for both.
- Builds, unofficial repositories and add-ons that promise free channels are not part of this setup, and we do not support them.
- If you want an Xtream Codes login, a portal or a remote-first TV layout, another player is usually simpler.
How Kodi and IPTV Fit Together
Kodi is a free, open-source media centre. On its own it plays files and network streams, but it has no live TV source built in. Live TV comes from a type of add-on called a PVR client, which connects Kodi's TV menus, channel list and guide to a source you supply.
The PVR IPTV Simple Client is the PVR client for IPTV. It reads an M3U playlist, lists every channel in it, and optionally reads an XMLTV guide file to fill the programme guide. Kodi then shows those channels in its TV section like any other live TV source.
That is the honest shape of Kodi and IPTV: Kodi is the screen, the add-on is the connector, and the channels come from a subscription you pay for separately. Searching for an IPTV player for Kodi usually means searching for this add-on, because it is the official route.
What You Need Before You Start
- Kodi from an official source. Install it from the store on your device where Kodi is listed, such as Google Play on Android phones and Android TV, or from the official Kodi website. If your device's store does not list Kodi, use a player that the store does list rather than a workaround.
- An M3U link. One long web address that returns your channel list. It often carries your username and password inside it, so treat it like a password.
- A guide link. Often called an EPG or XMLTV address. Without it, the channels play but the guide stays empty.
- A keyboard or a way to paste. The links are long. Copy them whole from the original message, because a link cut at a line break is the most common reason an M3U link fails.
How M3U links differ from Xtream Codes logins and portals, and why the format matters more than the app, is covered in the playlist guide.
How to Install the PVR IPTV Simple Client
Menu names shift a little between Kodi versions, so treat these as directions rather than exact labels.
- From Kodi's home screen, open Settings, then Add-ons.
- Choose Install from repository, then the Kodi Add-on repository.
- Open PVR clients and select PVR IPTV Simple Client.
- Choose Install and wait for the confirmation.
- Check that the add-on shows as enabled under My add-ons, PVR clients.
Every step stays inside Kodi's own repository. If a guide tells you to add a new file source, install a zip from an outside address or add another repository first, it is not the official route and not one we support.
Adding Your M3U Link and Guide Link
Open the add-on's settings from My add-ons, PVR clients, PVR IPTV Simple Client, then Configure.
- In the General section, set the location to a remote path, meaning an internet address.
- Paste your M3U link into the M3U playlist URL field.
- In the EPG section, set the location to a remote path as well.
- Paste your guide link into the XMLTV URL field.
- Confirm with OK. If no channels appear after a short wait, restart Kodi.
Then open TV from Kodi's home screen. Channels lists the line, and Guide shows the programme grid once the guide link has loaded. The first guide load can take a while on a large line, so give it time before changing settings.
If you later receive new details, edit the same fields rather than installing the add-on again.
When Channels or the Guide Do Not Load
Most problems are a link pasted into the wrong field or a link that never arrived. These are the ones we see most in support chats.
If the line fails in Kodi and in every other player, on every device, while other apps stream normally, the problem is the service rather than Kodi. The outage or local fault guide shows how to tell the two apart.
When Another Player Is the Better Choice
Kodi is a capable media centre, and for a viewer who already uses it, adding live TV through the Simple Client keeps everything in one place. It is not always the simplest IPTV player, though. Three situations favour something else.
- You watch with a TV remote. Kodi's interface covers music, films and pictures as well as TV, which means more menus between you and a channel. A player built around live TV, such as TiviMate on Android TV, is designed for the remote.
- The guide feels slow. In our experience, a large guide can take a while to load and refresh in Kodi, especially on a low-powered stick. A dedicated IPTV player often handles the same guide more smoothly on the same device.
- Your line is an Xtream Codes login or a portal. The Simple Client is set up with an M3U link. An Xtream Codes login suits apps such as IPTV Smarters and TiviMate, and a portal URL with a MAC address is the STBEmu and MAG format. Ask for the M3U version for Kodi, or keep your format and use a player built for it.
Most of these players cost nothing to install. The free player apps guide covers what free means for each, and the player guide compares them by device and login.
Builds, Unofficial Add-ons and Free Content
Search for Kodi IPTV and much of what appears is builds, unofficial repositories and add-ons that promise free channels. They are not part of the official Kodi add-on repository, and we do not support them or set lines up in them.
The reasons are practical. A build replaces Kodi's setup with someone else's, and it updates from whoever made it. An add-on that arrives with channels inside is carrying someone else's line or streams nobody had the right to share, and it stops when they are closed, with no one to ask. The setup in this guide avoids all of that: official Kodi, the official add-on, and a line issued to you.
Getting an M3U Link for Kodi
Tell us you are using Kodi and we send an M3U link in under 10 minutes. Ask for the guide link in the same message, so the guide fills in on the first load. If you later move to another player, we issue the same line in that player's format at no charge. If you need a subscription to go with Kodi, see the plans.
Kodi IPTV Questions
Is Kodi a good IPTV player?
It is a good choice if you already use Kodi and want live TV inside it. Install the PVR IPTV Simple Client from the official repository and add an M3U link and a guide link. If you only want live TV on a television with a remote, a dedicated IPTV player is usually quicker to use.
Is the PVR IPTV Simple Client free?
Yes. Kodi and the PVR IPTV Simple Client are both free, and the add-on installs from the official Kodi add-on repository inside the app. Neither includes channels. The channels come from the line you add.
Can Kodi use an Xtream Codes login or a portal?
The PVR IPTV Simple Client is set up with an M3U link, not an Xtream Codes login or a portal with a MAC address. The same line can usually be issued as an M3U link, so ask your provider for that. If you want to keep the other format, use a player built for it.
Does Kodi come with IPTV channels?
No. Kodi is a media centre and the add-on is a connector. Neither supplies channels, and an add-on that claims to is carrying someone else's line. You add a line from the provider you subscribe to.