Skip to content
IPTVSubTV
IPTV Apps

How to Set Up IPTV on Kodi with PVR IPTV Simple Client

Kodi's official PVR IPTV Simple Client turns your playlist into a full Live TV section with a guide. Here's the complete setup.

Published
Updated
Reading time
3 min read
Part of our guide: Best IPTV Player Apps Compared by Platform
Illustration of a media centre interface with a live TV guide section

Kodi is a free, open-source media centre for Android, Fire TV, Windows, macOS and Linux. With the official PVR IPTV Simple Client add-on, it can turn your IPTV playlist into a proper Live TV section with a programme guide.

It takes a few more steps than a dedicated player, but rewards you with a highly customisable setup. For simpler options, see best IPTV player apps.

Quick answer

To set up IPTV in Kodi, go to Settings → Add-ons → Install from repository → PVR clients, install PVR IPTV Simple Client, open Configure, add your M3U URL as a remote path and your XMLTV guide URL, restart Kodi and enable TV under PVR & Live TV.

Step 1: Install PVR IPTV Simple Client

  1. Open Add-ons

    From Kodi's home screen, select the settings (cog) icon, then Add-ons.

  2. Install from repository

    Choose Install from repository → Kodi Add-on repository → PVR clients.

  3. Select PVR IPTV Simple Client

    Select it and choose Install. It's an official add-on from the Kodi repository.

Step 2: Add your playlist and guide

  1. Open Configure

    After installation, select the add-on and choose Configure.

  2. M3U settings

    Set Location to Remote path (Internet address) and paste your M3U playlist URL.

  3. EPG settings

    Set Location to Remote path and paste the XMLTV guide URL, if your provider supplies one.

  4. Save and restart Kodi

    Select OK, then restart Kodi so the channels and guide load.

Newer Kodi versions let you add several configurations to the same add-on — useful if you have more than one playlist.

Step 3: Enable Live TV

Go to Settings → PVR & Live TV and make sure TV is enabled. A TV entry appears on the home screen, with Channels, Guide and Recordings sections. Use the Guide view for a grid like a cable box.

Useful settings

Kodi settings that help IPTV
SettingWhereWhy
Refresh M3U at startupSimple Client → GeneralPicks up channel changes
EPG time shiftSimple Client → EPGFixes guide times that are off by hours
Adjust display refresh rateSettings → Player → VideosSmoother playback by matching frame rate
Hardware accelerationSettings → Player → VideosLower CPU load, smoother HD and 4K

Troubleshooting Kodi IPTV

  • "PVR manager is starting up" for a long time: large playlists take a while on first load; wait, then restart Kodi.
  • No channels: check the M3U URL is complete; try opening it in VLC to confirm it works.
  • Guide empty: add the XMLTV URL and clear data in PVR & Live TV → General.
  • Stutter: see the buffering guide.

A note on third-party add-ons

Kodi itself is legitimate, but third-party add-ons from unknown repositories can be unsafe or provide unlicensed content. Stick to official add-ons such as PVR IPTV Simple Client — see is IPTV safe? and is IPTV legal?.

Kodi IPTV setup: frequently asked questions

Yes. It's available from the official Kodi add-on repository under PVR clients.

The Simple Client works with M3U playlists and XMLTV guides. Use the M3U URL from your activation details.

Add your provider's XMLTV URL in the EPG settings, restart Kodi, and clear PVR data if needed.

Conclusion

Kodi takes a few more steps than a dedicated player but gives you a highly customisable Live TV section. Stick to official add-ons.

Check your playlist quickly in VLC, learn about the IPTV EPG, and browse all IPTV Apps.

Browse IPTV Apps →
Illustration of a laptop playing a stream with a playlist panel on the side
IPTV Apps2 min read

How to Watch IPTV with VLC Media Player

VLC can play your IPTV playlist in seconds on almost any device. Here's how — and when a dedicated player is the better choice.

Illustration of several app windows showing TV guide grids and channel listsPillar guide
IPTV Apps5 min read

Best IPTV Player Apps Compared by Platform

TiviMate, Smarters, VLC, Kodi or a TV-native player? A platform-by-platform comparison to help you pick the right IPTV app.

Feature

EPG TV Guide

A good EPG turns a long channel list into a real TV guide. See how IPTV guide data works and how to fix the most common EPG problems.

Device

Windows & Mac

Turn your laptop or desktop into a TV with a desktop IPTV player or a general-purpose media player.

Ready to try IPTV for yourself?

Request your IPTV subscription and follow our step-by-step guides to start watching on the screens you already own.