Skip to content

How to Add IPTV Channels to Kodi With One Add-on

How to add IPTV channels to Kodi using the PVR IPTV Simple Client add-on and your subscription's M3U link or Xtream Codes login.

Updated August 2026

How to Add IPTV Channels to Kodi With One Add-on

Here's how to add IPTV channels to Kodi: install the PVR IPTV Simple Client add-on, then point it at your subscription's M3U playlist link or your Xtream Codes login.

Here's how to add IPTV channels to Kodi: install the PVR IPTV Simple Client add-on, then point it at your subscription's M3U playlist link or your Xtream Codes login. Kodi itself is just a media center with no channels built in on its own, so the add-on is what turns your subscription into a live TV guide inside the app. The whole process takes a few minutes once you have your playlist URL or login details on hand and ready to paste in.

DO

Daniel Osei

Support Lead

devices · 8 min read · Updated 2026-08-08

The numbers

What the figures actually say

about 5 minutes
Setup time
54,000+
Live channels included
1-5 devices
Simultaneous streams
$5 / 24 hours
Trial cost

In detail

The setup in one line

What add-on actually loads the channels?

PVR IPTV Simple Client is Kodi's built-in bridge between a live-TV playlist and Kodi's own TV interface, and it's the only piece you need for this to work. Go to Add-ons > Add-on browser > PVR clients and install or enable it, it ships bundled with most Kodi builds already, so you're usually just turning it on rather than downloading anything new from outside Kodi. Once enabled, it appears as a source you configure with your own playlist or login, and Kodi's TV section pulls every channel through it from that point forward, the same way it would pull from any other PVR backend.

M3U link or Xtream Codes: which do you enter?

M3U is a single playlist file URL you paste in directly, one field and you're done with that part of the setup. Xtream Codes instead asks for a server address, a username, and a password, three separate fields instead of one, and it usually pulls the program guide, the EPG, automatically along with the channel list in the same step. An M3U setup needs a separate EPG URL added by hand afterward, which is an easy step to miss, so Xtream Codes ends up being the simpler of the two whenever your provider happens to offer both formats to choose from.

Why are my channels loading but the guide is blank?

The EPG is a separate feed from the channel list itself, pulled from its own URL rather than bundled into the playlist file, so a working channel list next to a blank guide almost always means that EPG URL field is empty or pointed somewhere wrong. This is the single most common oversight in a Kodi IPTV setup: everything plays fine when you tap a channel, but nothing ever shows a schedule underneath it, simply because the guide was never actually told where to pull its data from during the initial setup steps.

Does Kodi affect stream quality?

Kodi just plays what's sent to it over the connection; quality is set by your plan's bitrate, not by the add-on itself, roughly 5-8 Mbps for 1080p or 15-25 Mbps for 4K, which works out to about 3 GB or 7 GB of data an hour respectively depending on the resolution you pick. Turning on hardware decoding in Kodi's player settings helps lower-power boxes keep up smoothly without dropped frames during playback, but it won't raise picture quality any higher than what your subscription and your home connection already support together at any given moment.

Step by step

  1. 1

    Install the PVR IPTV Simple Client add-on

    Open Kodi, go to Add-ons > Add-on browser > PVR clients, and install PVR IPTV Simple Client.

    Tip · It ships with Kodi by default on most builds, so you're usually just enabling it.

  2. 2

    Open the add-on's configuration

    Go to Settings > Player > TV settings, or the add-on's own settings icon, and pick your source: an M3U playlist URL or an Xtream Codes login.

  3. 3

    Enter your playlist or login

    Paste your M3U URL, or enter the Xtream Codes server address, username, and password from your subscription.

    Tip · Copy these directly from your account to avoid a typo, one wrong character breaks the whole list.

  4. 4

    Add the EPG source

    Paste the separate EPG URL your provider gives you, or confirm Xtream Codes pulled it automatically, so the on-screen program guide populates.

  5. 5

    Enable the PVR client and reload channels

    Turn the add-on on, then open Kodi's TV section and let it load; the first import can take a minute or two on a large channel list.

  6. 6

    Hide unused channel groups

    In the guide settings, hide language or category groups you don't watch.

    Tip · A large visible list can slow the interface down, so trimming it keeps browsing quick.

  7. 7

    Test playback on a few channels

    Open two or three channels from different categories to confirm video and EPG both work before relying on the setup for something you plan to watch live.

Verified service facts

Confirmed

A device operating system's built-in accessibility layer (screen readers, magnification, color adjustments) operates independently of any individual streaming app's own accessibility settings, and the two do not automatically sync with each other.

Confirmed

Standard consumer infrared remote signals have no built-in device-addressing field the way Bluetooth pairing does, so any IR receiver within line of sight and using a matching code set will respond to the same signal, regardless of which specific unit the remote was intended for.

Confirmed

Player apps differ in buffer strategy and decoder selection, so the same line can behave differently in two apps on the same device. Trying a second player is a legitimate diagnostic step.

Questions

How to Add IPTV Channels to Kodi With One Add-on — questions people ask

Do I need Xtream Codes or is M3U enough?
Either one works fine for basic playback. Xtream Codes usually pulls the program guide automatically along with the channel list in a single step, while a plain M3U link needs a separate EPG URL pasted in by hand afterward, which is an easy thing to forget. If your provider gives you Xtream Codes details, that's generally the simpler of the two formats to get fully working inside Kodi with the guide included.
Why does Kodi say the channel list failed to load?
Usually a copied URL has an extra space at the end or a missing character somewhere in the middle, which is the single most common cause of a broken IPTV setup on any platform, not just Kodi specifically. Re-copy the link straight from your account page rather than retyping it by hand, and confirm your internet connection is actually active before assuming the subscription itself is the problem.
Can Kodi replace a dedicated IPTV app?
For many people, yes, it genuinely can. Kodi with the PVR IPTV Simple Client add-on does the same core job as a standalone player app, and it runs on Android boxes, Fire TV devices, Windows computers, and more without much difference between platforms. The tradeoff is a slightly more technical setup process than an app that was built specifically for IPTV playback right out of the box.
Why do my channels play but freeze after a few minutes?
A live stream arrives in short segments, usually just a few seconds each, and a stall longer than Kodi's buffer window shows up on screen as a visible freeze rather than a smooth pause. Try switching the channel away and then back again, if it recovers instantly, the session itself stalled rather than your bandwidth being the real cause, and reloading the add-on's playlist from scratch often clears the problem for good after that.
Does adding IPTV channels to Kodi affect other Kodi add-ons?
No, it doesn't touch anything else you already have installed on your setup. PVR IPTV Simple Client runs independently of your other Kodi add-ons and your existing media library, so adding a live-TV source through it doesn't change how movies, shows, or any other unrelated add-on behaves once everything is fully set up and running side by side on the same box.
Is there a channel limit Kodi can handle?
Kodi and its PVR add-on can technically load very large lists without erroring out, but performance drops noticeably once a visible list runs into the tens of thousands of channels, since the app holds the entire list in memory the whole time it's open. Hiding unused language or category groups keeps the guide feeling responsive and quick to browse, even on a genuinely large subscription behind the scenes.

The setup in one line

One add-on, one playlist or login, one EPG link, that's the whole job. Once it's in, Kodi treats live IPTV the same as any other source in its guide.

Test the setup before committing

Use the $5, 24-hour trial to confirm your Kodi add-on loads channels and the guide correctly before choosing a plan.

DO

Editor’s pick

Picked by Daniel Osei · Support Lead

I'd grab your Xtream Codes details over an M3U link if your provider offers both, since it saves you from hunting down a separate EPG URL. Test the setup with our $5 trial before adding it to a 12-month plan.

Need Help?