How to Watch IPTV on Kodi: PVR IPTV Simple Client Setup (2026)

Wondering how to watch IPTV on Kodi? The answer is simpler than most tutorials make it sound: you install the PVR IPTV Simple Client add-on — an official add-on that ships inside Kodi itself — and point it at your licensed provider’s M3U playlist. No third-party repositories, no “unknown sources” toggle, no sketchy downloads. Once it’s set up, your live channels, program guide, and channel groups appear natively in Kodi’s TV section, alongside everything else in your media center.

This guide walks you through the full setup step by step: installing the add-on, adding your M3U playlist and EPG, getting the TV menu to appear, and fixing the problems that most commonly trip people up when they first learn how to watch IPTV on Kodi.

Quick legality note: Kodi is free, open-source media software — it’s 100% legal, and it comes with no channels of its own. The PVR IPTV Simple Client is equally legal: it’s an empty player shell. Whether your setup is legal depends entirely on the playlist you feed it, so use a licensed IPTV provider. Our Is IPTV Legal guide explains the difference in plain English.

What you need before you start

Watching IPTV on Kodi has three ingredients. Get these ready before you open Kodi’s settings:

1. Kodi installed. Download it only from the official source — kodi.tv — for Windows, macOS, Linux, Android, Android TV, Fire TV, or Raspberry Pi. Kodi 20 (Nexus) or newer works for this guide; the steps are the same on all of them.
2. A licensed IPTV subscription that includes an M3U playlist URL. The PVR IPTV Simple Client reads M3U playlists — that’s the single long link your provider gives you containing your channel list. If your provider also supplies an EPG (XMLTV) URL, keep that handy too; it fills in the program guide.
3. A stable internet connection. Wired Ethernet is ideal for HD channels, but solid Wi-Fi works for most setups.

A note on Xtream Codes logins: some providers issue a server URL, username, and password (Xtream Codes API format) instead of an M3U link. The Simple Client doesn’t take API logins — it only reads M3U. Most providers that offer Xtream logins also generate an equivalent M3U URL for the same account; check your provider’s dashboard or ask their support for it. If you prefer the Xtream route, a dedicated IPTV player app that supports API logins is the smoother option.

Step 1: Install PVR IPTV Simple Client

Learning how to watch IPTV on Kodi starts with the easiest step — there is nothing to download from the internet. The add-on is already inside Kodi, in the official add-on repository.

1. Open Kodi and click the gear icon (Settings) in the top-left corner.
2. Select Add-ons.
3. Select Install from repository (in some skins this appears under the add-on browser — the open-box icon on the Add-ons screen).
4. Choose Kodi Add-on repository.
5. Scroll down and open PVR clients.
6. Find PVR IPTV Simple Client in the list and select it.
7. Click Install. Wait for the “Add-on installed” notification in the top-right corner.

On recent Kodi versions the add-on may already be present but disabled — if so, you’ll see “Enable” instead of “Install.” Enable it, and you’re on to step 2.

Why the official route matters: third-party “Kodi builds” and plugin repositories are where most Kodi problems — and legal problems — come from. Everything in this guide uses only add-ons from Kodi’s own repository, so there’s nothing sketchy to update, uninstall, or worry about later.

Step 2: Add your M3U playlist

Now tell the add-on where your channels live.

1. Go back to Settings → Add-ons → My add-ons → PVR clients → PVR IPTV Simple Client.
2. Select Configure.
3. In the General tab, click M3U Playlist URL (on older versions this is labeled “M3U Play List URL”).
4. Paste in the M3U playlist URL from your provider, then press OK. (If your playlist is a file on your device instead of a link, change the Location setting to “Local path” and select the file.)
5. Leave the other settings at their defaults for now — they handle channel logos, catch-up, and stream options you may not need.

Pasting long URLs on a TV: if you’re setting this up on an Android TV box or Fire TV, typing a 100-character URL with a remote is miserable. Open the same URL in your provider’s dashboard on your phone or laptop, copy it, and send it to yourself — via email, a messaging app, or Kodi’s built-in web interface — then paste it into the field. Entering the URL wrong is the single most common reason the setup fails.

Step 3: Add your EPG (program guide)

Without this step your channels will play, but the guide will be blank. If your provider gave you an XMLTV/EPG URL:

1. In the add-on’s Configure dialog, switch to the EPG Settings tab.
2. Click XMLTV URL and paste in your provider’s EPG link.
3. Press OK to save everything and close the dialog.

Don’t have an EPG URL? Ask your provider — most licensed services include one. Our What Is EPG on IPTV explainer covers what the guide does and why it makes channel surfing so much better.

Step 4: Enable Live TV and restart Kodi

With the playlist and EPG configured, turn on the TV section:

1. Still in Settings → Add-ons → My add-ons → PVR clients → PVR IPTV Simple Client, make sure the add-on shows as Enabled (toggle it on if it doesn’t).
2. Press OK on the configuration dialog to save.
3. Restart Kodi completely — don’t just go back to the home screen. When Kodi relaunches, you’ll see a “PVR manager is starting up” message in the top-right, followed by a notification telling you how many channels were loaded.

After the restart, a TV entry appears in Kodi’s main menu. Open it and you’ll find:

• Channels — your full channel list, grouped the way your playlist organizes them.
• Guide — the EPG timeline grid, now populated with program data.
• Timers and Recordings — part of Kodi’s PVR interface (recording support is limited with this particular add-on; see the FAQ).

The first channel load can take a minute or two on a large playlist — give it time before assuming something’s broken. Once it finishes loading, you’re ready to watch IPTV on Kodi.

What you get (and what you don’t)

Kodi treats your IPTV channels as a genuine PVR source, which feels different from a standalone channel-list app. Here’s an honest picture of the experience:

What you get:

• Live channels with a real program guide, channel groups, and a remote-friendly TV interface.
• One interface for everything — your local movie library, add-ons, and live TV live side by side.
• It’s free, open-source, and runs on almost anything — PC, Android TV box, Fire TV, Raspberry Pi.

What you don’t get:

• The slickest guide experience. Dedicated players like TiviMate are purpose-built for live TV and usually feel snappier for pure channel surfing — our IPTV player explainer compares the options.
• Built-in recording. The Simple Client is deliberately minimal and doesn’t include server-style DVR features. If catch-up or recording matters to you, check whether your provider’s playlist includes catch-up entries, or use a player that supports them.

How to watch IPTV on Kodi on different devices: Fire TV, Android TV, Raspberry Pi

The setup steps above are identical on every platform, but a few platform notes are worth knowing:

• Windows, macOS, Linux: the easiest path — download from kodi.tv, install, and follow the steps above with a real keyboard for pasting URLs.
• Android TV / Google TV: install Kodi from the Google Play Store. Use the Google TV app or a phone-to-TV paste trick for the long playlist URL.
• Amazon Fire TV / Firestick: Kodi isn’t in the Amazon Appstore, so it has to be sideloaded with the Downloader app using Kodi’s official Android APK link from kodi.tv. If that sounds like work, our Firestick IPTV setup guide covers player apps that install directly from the Amazon store.
• Raspberry Pi: LibreELEC and OSMC both include Kodi with the PVR clients available; the setup is the same once Kodi is running.

Troubleshooting: the fixes that actually work

Problem	Fix
No TV section appears after restart	The add-on isn’t enabled. Go to Settings → Add-ons → My add-ons → PVR clients → PVR IPTV Simple Client and confirm it says Enabled. Then restart Kodi again — fully, not just to the home screen.
Channels list is empty	Your M3U URL is wrong, expired, or unreachable. Open it in a browser or VLC on another device first — if it doesn’t work there, it won’t work in Kodi. Re-copy it from your provider’s dashboard and re-paste it.
Channels load but won’t play	Check your internet connection and try another channel. Persistent playback failure across all channels usually means the playlist itself is broken — test it in VLC to confirm before changing Kodi settings. If everything buffers, our IPTV buffering fixes apply here too.
EPG is blank or shows wrong times	Double-check the XMLTV URL in EPG Settings, then force a guide refresh: Settings → PVR & Live TV → Guide → “Clear data” and restart. Wrong program times usually come from the EPG source’s time zone, not Kodi — ask your provider which time zone their feed uses.
Add-on disabled itself after a Kodi update	Re-enable it under My add-ons → PVR clients. Major Kodi version upgrades sometimes disable PVR clients; your playlist and EPG settings are preserved, so you only need to flip the switch.
Only some channels appear	Your playlist may include groups your provider has hidden, or the M3U is filtered by your subscription tier. Compare against your provider’s channel list — Kodi can only show what’s in the playlist.

Frequently asked questions

Is watching IPTV on Kodi legal?

Kodi itself is completely legal, free, open-source software — it’s just a media player. The PVR IPTV Simple Client is an official add-on with no channels of its own. Legality comes down to your playlist: use a licensed provider and you’re fine. Is IPTV Legal breaks the details down.

Does Kodi come with free IPTV channels?

No. Kodi ships with zero channels and zero playlists. Anyone promising “free IPTV channels built into Kodi” is describing either a third-party add-on you shouldn’t install or an unlicensed stream you shouldn’t watch. You bring your own licensed playlist; Kodi just plays it.

Do I need a VPN to watch IPTV on Kodi?

Not necessarily. A VPN isn’t required for Kodi or the Simple Client to function. Some users choose one for privacy on public networks or when traveling. Our honest breakdown — Do You Need a VPN for IPTV? — covers when it helps and when it’s just marketing.

Can I add more than one playlist?

The Simple Client handles one M3U playlist per setup. If you have two providers, you’ll need to either combine the playlists into a single M3U file or look at a more advanced player. For most people, one good licensed subscription is plenty.

Can I record IPTV on Kodi?

Not really with this add-on — the Simple Client is intentionally minimal and doesn’t support recording or timers the way a full PVR backend (like NextPVR or Tvheadend) does. If recording is a must-have, pair Kodi with one of those backends or choose a dedicated IPTV player with catch-up support.

Why is my EPG guide empty even though channels work?

Nine times out of ten the XMLTV URL is missing, mistyped, or expired. Channels come from the M3U; the guide comes from the EPG URL — they’re independent. Re-paste the XMLTV link in the add-on’s EPG Settings tab and restart Kodi.

The bottom line

PVR IPTV Simple Client is the cleanest way to watch IPTV on Kodi: it’s official, it’s already in the repository, and the whole setup takes about ten minutes — install, paste your M3U URL, paste your EPG URL, enable, restart. No third-party repositories, no builds, no drama. Keep your playlist from a licensed provider, keep Kodi updated from kodi.tv, and your media center becomes a proper live-TV setup.

If Kodi feels like overkill for just watching channels, a purpose-built IPTV player on the same device is worth a look — and if you’re setting this up on an Amazon stick, the Firestick guide gets you there faster.