IPTV on Kodi: How to Set Up PVR IPTV Simple Client (M3U + EPG)
Set up Kodi for live TV with the PVR IPTV Simple Client: add your M3U playlist, load the EPG, fix common errors and keep playback smooth.
Kodi is a free, open-source media centre that runs on Firestick, Android boxes, Windows, Mac, Linux and even a Raspberry Pi. It does not come with any channels, but it has an excellent built-in live TV section. To watch IPTV on Kodi you only need one official add-on, the PVR IPTV Simple Client, plus your M3U link and EPG address. This guide walks you through every step, from installing the add-on to getting a full TV guide on screen.
Table of Contents

What you need
- Kodi 20 (Nexus) or Kodi 21 (Omega) or newer, installed from your device’s app store or the official website.
- Your M3U playlist link from your subscription or free trial.
- Your XMLTV EPG link (the address of the TV guide), if your provider supplies one separately.
- A stable internet connection – ideally wired. See our Wi-Fi vs Ethernet guide.
If you are not sure what an M3U link is or how it differs from an Xtream login, read M3U vs Xtream Codes first. The Simple Client works with M3U links, so that is the format to ask for.
Step 1: install the PVR IPTV Simple Client
- Open Kodi and go to Settings (the cog icon) > Add-ons.
- Choose Install from repository > Kodi Add-on repository > PVR clients.
- Select PVR IPTV Simple Client and press Install.
The add-on comes from the official Kodi repository, so you do not need any third-party sources. On some Linux builds it is already included but disabled; in that case go to My add-ons > PVR clients and enable it. You can read the full add-on documentation on the Kodi wiki.

Step 2: add your M3U playlist
- Open My add-ons > PVR clients > PVR IPTV Simple Client and press Configure.
- Kodi 20 and later supports several instances. Choose Add add-on configuration and give it a name such as “BritishTV Plus”.
- In the General tab, set Location to Remote path (internet address).
- Paste your link into M3U play list URL. Type carefully or use a keyboard app on your phone.
- Leave Cache M3U at local storage on so the list loads faster next time.
Press OK. Kodi will ask to restart the add-on; accept and wait while it downloads the channel list.
Step 3: add the EPG (TV guide)
Many M3U links already contain the guide address in the first line, and the Simple Client picks it up automatically. If your guide stays empty, add it by hand:
- Open the configuration again and go to the EPG tab.
- Set Location to Remote path and paste your XMLTV link.
- Set EPG time shift to 0 for UK time. Only change it if the whole guide is consistently out by the same number of hours.
- In Kodi’s main Settings > PVR & Live TV > Guide, set how many days to load. Three to five days is plenty and keeps low-power devices fast.
If programmes still do not match, our EPG fix guide explains channel IDs and how to clear old guide data.
Step 4: find your channels
Go back to the home screen and choose TV. You will see a list of channels grouped by the categories in your playlist. Press Guide for the grid view. Kodi also lets you add channel groups and favourites under Channels > Manage, which is handy if your list is long.
To make live TV the first thing you see, open Settings > Interface > Startup > Startup window and pick TV channels or Guide.
Settings for smooth playback
- Player > Videos > Adjust display refresh rate: set to On start/stop so 50Hz UK broadcasts look natural.
- Settings > PVR & Live TV > Playback: turn off Start playback minimised so channels open full screen.
- Enable hardware acceleration (MediaCodec on Android, VAAPI or DXVA on PC) under Player > Videos.
- Clear the Kodi thumbnail cache now and then on small devices; see our Firestick cache guide.
If you see pauses, use a wired connection and read our buffering fixes.
Common problems and fixes
“Unable to load playlist” or no channels
Check the link in a web browser on another device. If it downloads a file, the link works and the problem is a typing mistake. Also check that your trial or plan is active.
Guide shows “No information available”
Add the EPG link manually, then go to Settings > PVR & Live TV > General > Clear data and restart Kodi.
Channels freeze after a few seconds
This usually means the login is in use on another device. Each connection counts separately; see how connections work.
Kodi is slow with a big list
Reduce guide days, hide categories you never watch and avoid heavy skins on older sticks.
Kodi or a dedicated player?
Kodi is ideal if you already use it for your own films and music, or if you want one interface for everything. It is free and highly customisable. Dedicated players such as TiviMate are simpler for live TV and usually faster with large guides. Compare them in our best IPTV app guide. Whichever you choose, your subscription works the same way.
Tips for a better Kodi experience
Kodi rewards a little tidying. Start by choosing a lighter skin if your device is older; the default Estuary skin is fine on most sticks, but busy third-party skins can slow menus considerably. Next, open Settings > PVR & Live TV > Menu/OSD and enable channel numbers so you can type a number on the remote to jump straight to a channel.
It also helps to set the guide to refresh at start-up only, rather than constantly in the background. This keeps the interface responsive while you browse. If several people use the same box, consider Kodi profiles: each person gets their own favourites, layout and settings, while sharing the same playlist.
Finally, keep Kodi itself up to date. New versions bring better hardware decoding, fixes for the live TV section and improved support for modern TVs. Before upgrading a major version, write down your playlist and guide links so you can re-enter them quickly if the add-on settings reset. A short note on your phone with both links saves a lot of time later.
Using a remote or keyboard
The Kore app (official Kodi remote for Android and iOS) lets you control Kodi from your phone and type long links using your phone’s keyboard, which is much quicker than an on-screen keyboard.
Frequently asked questions
Is the PVR IPTV Simple Client free?
Yes. It is part of the official Kodi repository and costs nothing. It is an empty player, so you need your own playlist.
Can I use an Xtream login in Kodi?
The Simple Client needs an M3U link. Ask us and we will send your details in M3U format.
Does Kodi support catch-up?
Yes, when the playlist includes catch-up tags. Learn more in IPTV catch-up explained.
Which device runs Kodi best?
A recent Android TV box or a Firestick 4K Max works well. Older sticks cope fine with a short guide and a light skin.
Try IPTV on Kodi free
Want to test before you pay? Ask for a free IPTV trial on WhatsApp, mention that you use Kodi, and we will send an M3U link and EPG address ready to paste. When you are happy, choose from our IPTV plans, starting from £9.99/month.
Quick summary
Install the PVR IPTV Simple Client from the official Kodi repository, paste your M3U link, add the EPG address if needed and open the TV section. Tune refresh rate and hardware acceleration for smooth live TV.
Request your free trial
Leave your details and we will contact you to set up a free trial on your device.
Ready when you are
Choose a plan or try it free first. We reply on WhatsApp every day.