Skip to content
IPTV Smarters Pro
Setup

Kodi with PVR IPTV Simple Client: add an M3U playlist and an XMLTV guide

Published 3 min read

Illustration of a TV screen showing a channel list beside a programme guide grid

Kodi is a free media centre, and with the PVR IPTV Simple Client add-on it can show your channels together with a programme guide. This guide explains which settings to fill in for an M3U playlist and an XMLTV guide, using the setting names from the add-on's official documentation. Facts were checked on 17 November 2026.

Kodi and PVR IPTV Simple Client in brief

  • Kodi is free and open source software under the GPLv2 licence. Its official repository lists native versions for Android, Linux, BSD, macOS, iOS, tvOS and Windows.
  • PVR IPTV Simple Client is, in its own words, an "IPTV Live TV and Radio PVR client addon for Kodi". It reads an M3U playlist for channels and an XMLTV file for the guide, including XMLTV files compressed with Gzip or XZ.

The add-on's documentation does not describe the menus for installing it. In Kodi, look for it by name, PVR IPTV Simple Client, among the add-ons, then open its Configure screen. Labels can differ depending on your Kodi version and language.

Step 1: add your M3U playlist

In the add-on's General settings:

  1. Set Location to Remote path if your playlist is a web address, or Local path if it is a file on your device.
  2. Enter the address in M3U play list URL (remote) or choose the file in M3U play list path (local).
  3. With a remote playlist, you can enable Cache M3U at local storage.
  4. If your list changes regularly, Auto refresh mode can reload it: disabled, at a set interval or once per day.

The add-on needs a playlist. If your service only gave you a server address, a username and a password, read M3U or Xtream login: in the add-on's documentation, Xtream Codes appears only as a catch-up URL format, not as a login method.

Step 2: add the XMLTV guide

In the EPG settings:

  1. Set Location to Remote path or Local path.
  2. Enter the guide address in XMLTV URL, or choose the file in XMLTV path.
  3. If times are off, adjust EPG time shift, which goes from -12 to +14 hours. Apply time shift to all channels applies it everywhere.

Our article on how to add an EPG explains how XMLTV guide data works and what to do when listings are missing.

Step 3: channel logos and refresh

The Channel Logos settings take a local folder or a base URL. The Channel logos from XMLTV option chooses between Ignore, Prefer M3U and Prefer XMLTV when both sources provide a logo.

After changing a source, the documentation points to two places to clear Kodi's cache: Settings > PVR & Live TV > Guide > Clear cache for the guide and Settings > PVR & Live TV > General > Clear cache for channels.

Good to know

  • The add-on has setting levels (Basic, Standard, Advanced and Expert): some options only appear at higher levels.
  • Since Kodi 20 (Nexus), several M3U and XMLTV pairs can be used, by adding another configuration from the add-on's settings with Add add-on configuration.
  • Catch-up works only if your provider supports it.

If you just want to check that a playlist plays, VLC is quicker. To compare players on your device, see IPTV players for Android or IPTV apps for Mac.

Frequently asked questions

Can I log in with an Xtream username and password?

Not as a login method: the add-on works from an M3U playlist. See M3U or Xtream.

Does it accept a compressed guide?

Yes. The documentation states support for XMLTV compressed with Gzip and XZ.

Is Kodi free?

Yes. Kodi is free and open source, licensed under GPLv2.

In short

In Kodi, PVR IPTV Simple Client needs two things: an M3U playlist in the General settings and, for the guide, an XMLTV source in the EPG settings. Adjust the time shift and logos if needed, and use a playlist from a service you are entitled to use.

Sources

The official pages behind the facts in this article. Stores and websites change, so each source shows the date we checked it.

Keep reading