UNITED PREMIUMAll articlesApp
Setup

Kodi IPTV Setup: PVR IPTV Simple Client with M3U and XMLTV

·7 min read

Hands setting up IPTV in Kodi on a TV connected to a mini PC

Kodi needs no extra app for IPTV: install the PVR IPTV Simple Client add-on from Kodi's official repository and enter your M3U link and programme guide (XMLTV) address in its settings. Channels then appear under TV in Kodi's main menu, complete with a guide. The add-on is free and comes from the Kodi team's own repository.

Why only the official repository

Kodi itself is a player with no content. The "Kodi builds" and third-party repositories passed around online claim to fill that gap, but their add-ons don't go through the Kodi team's review and can run whatever code they like on your device. Nothing in this guide needs a third-party repository. Keep Unknown sources switched off in the settings; if a guide asks you to turn it on, it isn't describing the official add-on.

Before you start

  • Install Kodi only from kodi.tv or your device's official store (Google Play, Microsoft Store).
  • Get the M3U link and the XMLTV address for the guide from your provider. If you have Xtream details, the provider can build both from them.
  • On Linux, PVR add-ons usually aren't in the Kodi repository but in your distribution's package manager as a separate package.

Which devices run Kodi

DeviceWhere to get KodiNote
Windowskodi.tv or Microsoft StoreSetup is easiest with keyboard and mouse
Android TV and TV boxesGoogle PlayComfortable with a remote
Amazon Fire TV (Fire OS)APK from kodi.tv via DownloaderNot on Vega OS models
LG webOSwebOS build on kodi.tvNot a store app; steps are on kodi.tv
Linux and Raspberry PiPackage manager or LibreELECThe PVR add-on may be a separate package

M3U and XMLTV addresses from Xtream details

PVR IPTV Simple Client doesn't take an Xtream login directly; it wants an M3U link. If your provider only gave you a server address, username and password, ask them to build both addresses from those. On most Xtream-based servers the M3U address ends in get.php and the guide address in xmltv.php, with your username and password inside the address. If you build it yourself, type=m3u_plus in the M3U address carries channel groups and EPG IDs; without it the guide won't match.

Kodi IPTV setup, step by step

  1. 01Open the add-ons sectionOn the home screen, press the cog icon for Settings, go to Add-ons and choose Install from repository.
  2. 02Find PVR IPTV Simple ClientIn the Kodi Add-on repository, open the PVR clients category, select PVR IPTV Simple Client and press Install.
  3. 03Open its settingsWhen installation finishes, press Configure on the add-on's page. If you see few options, raise the settings level at the bottom of the window to Standard or Advanced; some fields only show at higher levels.
  4. 04Enter the M3U linkOn the General tab, set Location to Remote path and paste the link into M3U play list URL. If the file is on the device, choose Local path and point to it.
  5. 05Enter the XMLTV addressOn the EPG tab, set Location to Remote path again and enter the guide address in XMLTV URL. The add-on also reads XMLTV files compressed with gzip or XZ.
  6. 06Restart KodiSave the settings, then close and reopen Kodi. Channels appear under TV in the main menu and the guide under the Guide tab. The first guide load can take a few minutes on large lists.

The M3U link carries your username and password in plain text. Blur it before posting a screenshot of the settings on a forum; anyone who sees the link can use your account.

Extra settings that help

Setting (tab)What it doesWhen
Auto refresh mode (General)Refreshes list and guide at an interval or once a dayIf your provider updates the list often
Cache M3U at local storage (General)Caches the list on the deviceIf startup is slow; disabled while auto refresh is on
TV group mode (Groups)Loads only the groups you pickIf the list runs to thousands of channels
EPG time shift (EPG)Shifts guide times between -12 and +14 hoursIf programme times are out
Catchup (Catchup)Opens the provider's archive from the guideIf the provider keeps an archive

For moving freely through the archive, the add-on's documentation recommends the inputstream.ffmpegdirect component: with it you can jump to any point within the archive window the provider allows, switch channels and come back. It is also in the official repository, under VideoPlayer InputStream.

From Kodi 20 (Nexus) onwards, the add-on supports more than one M3U and XMLTV pair: on the Configure screen, Add add-on configuration opens a second configuration. If you use two separate lists on the same device, there's no need to merge them into one file.

Common problems

  • No TV entry in the main menu: under Settings > Interface > Skin, open the skin configuration and make TV visible among the main menu items.
  • Channels but an empty guide: the tvg-id values in the list may not match the channel IDs in the XMLTV. Turn on the option to ignore case for EPG channel IDs on the EPG tab.
  • Guide an hour out: check the time zone in Kodi's Regional settings first, then correct with EPG time shift if needed. UK users often see this right after the clocks change.
  • A channel won't play: try the same link in VLC. If it fails there too, the problem is the list, not the add-on.
Support and free trialKodi IPTV Setup: PVR IPTV Simple Client with M3U and XMLTV