Kodi with PVR IPTV Simple Client: add an M3U playlist and an XMLTV guide
Published 3 min read

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:
- Set Location to Remote path if your playlist is a web address, or Local path if it is a file on your device.
- Enter the address in M3U play list URL (remote) or choose the file in M3U play list path (local).
- With a remote playlist, you can enable Cache M3U at local storage.
- 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:
- Set Location to Remote path or Local path.
- Enter the guide address in XMLTV URL, or choose the file in XMLTV path.
- 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.
- Kodi – PVR IPTV Simple Client add-on (GitHub) · checked on 17 November 2026
- Kodi – official source repository (GitHub) · checked on 17 November 2026
Keep reading

Setup
How to add an EPG programme guide to your player app
Learn what EPG and XMLTV data are, how to add a guide source to your player app and what to do when listings are missing or wrong.
3 min read

Setup
How to open an M3U playlist in VLC media player
Open an M3U playlist link in VLC on Windows or Mac: what an M3U file is, the exact menu to use, the limits of VLC and when to pick another player.
3 min read

Basics
M3U playlist or Xtream login: which one should you use?
M3U links and Xtream-style logins both load channels into a player app, but they behave differently. Learn how each works and when to use it.
4 min read
