How to Add IPTV to Kodi: Complete UK Setup Guide
Step-by-step guide to adding IPTV to Kodi using PVR IPTV Simple Client. Covers M3U setup, Xtream Codes, EPG configuration, device-specific notes, and common fixes — written for UK users.
By MaxConnect

To add IPTV to Kodi, enable the built-in addon called PVR IPTV Simple Client — no third-party repository required. You will need either an M3U playlist URL or Xtream Codes credentials (server URL, username, and password) from your IPTV provider. Once enabled and configured, the full setup takes around five minutes.
What is PVR IPTV Simple Client and is it already installed?
PVR IPTV Simple Client is Kodi's built-in addon for reading M3U playlists and XMLTV Electronic Programme Guide (EPG) sources. It sits in the PVR clients category within Kodi's addon system and handles the connection between your IPTV provider's channel list and Kodi's Live TV interface.
In Kodi Omega (v21), PVR IPTV Simple Client is bundled with the standard installation — it does not need to be downloaded from an external source. On most platforms it arrives in a disabled state and needs only to be enabled from within the Kodi interface.
No third-party repository is required. The steps below explain how to locate and enable it.
How to enable PVR IPTV Simple Client in Kodi
These steps are written for Kodi Omega (v21) using the default Estuary skin. If you are using a different skin, the visual layout will differ but the underlying menu structure remains the same.
- Open Add-ons — From the Kodi home screen, select 'Add-ons' from the left-hand sidebar.
- Go to My add-ons — Select 'My add-ons' from the Add-ons menu. This section lists all addons that are either already installed or bundled with your Kodi installation.
- Open PVR clients — Scroll down to the 'PVR clients' category and select it. You will see a list of available PVR addons, including PVR IPTV Simple Client.
- Select PVR IPTV Simple Client — Find 'PVR IPTV Simple Client' in the list and select it to open its detail screen. [SCREENSHOT REQUIRED: Kodi Add-ons > My add-ons > PVR clients screen showing PVR IPTV Simple Client listed]
- Enable the addon — On the addon detail screen, select the 'Enable' button at the bottom of the screen. If the button reads 'Install' rather than 'Enable', the addon is not yet present on your system — select 'Install' and wait for the download to complete, then confirm it is enabled.
- Return to the home screen — Press the back button to return to the home screen. A notification bar at the top of the screen should confirm the addon is now active. Live TV and Radio options will appear in Kodi's main navigation menu.
How to add your M3U playlist URL to Kodi
Once PVR IPTV Simple Client is enabled, open its settings to enter your M3U URL. Have the URL from your IPTV provider ready before starting.
- Open PVR IPTV Simple Client settings — Go to Add-ons > My add-ons > PVR clients > PVR IPTV Simple Client. On the addon detail screen, select 'Configure' to open the settings panel.
- Select the General tab — The settings panel opens on the 'General' tab by default. Stay on this tab — your M3U URL is entered here.
- Set the playlist location to Remote path (Internet address) — Find the 'M3U Play List Path' field. It will show a location type selector — change this to 'Remote path (Internet address)' if it is not already set that way. This tells Kodi to fetch the playlist from a URL rather than a local file.
- Enter your M3U URL — Paste or type the M3U URL provided by your IPTV provider into the URL field directly below the location type selector. Enter it exactly as given — any extra spaces or missing characters will prevent channels from loading. [SCREENSHOT REQUIRED: PVR IPTV Simple Client settings — General tab showing M3U Play List Path field with Remote path selected and URL field visible]
- Add a descriptive name (optional but recommended) — If a 'M3U Play List Name' or similar name field is available, entering a short descriptive label helps identify your source if you add more than one playlist later.
- Save and close settings — Select 'OK' to apply your settings and close the panel.
- Wait for channels to load — Kodi will download and parse your M3U playlist. On the first load this may take up to a minute depending on the size of the channel list. A notification will confirm when channels are ready. Navigate to TV > Channels to view your list.
How to set up using Xtream Codes credentials
If your IPTV provider gave you a server URL, username, and password rather than an M3U link, use the Xtream Codes method. Xtream Codes API support was added to pvr.iptvsimple in version 3.0.0 — this feature is included in the version bundled with Kodi Omega (v21). Check with your provider which connection method they support — some offer both M3U and Xtream Codes.
- Open PVR IPTV Simple Client settings — Go to Add-ons > My add-ons > PVR clients > PVR IPTV Simple Client and select 'Configure'.
- Select the Xtream Codes connection type — In the 'General' tab, locate the 'M3U Play List Path' location type selector. Change this from 'Remote path' to 'Xtream Codes API' (or the equivalent option label). Once selected, dedicated fields for the server URL, username, and password will appear below.
- Enter your server URL — Type the server URL exactly as provided by your IPTV provider into the server address field. Do not add or remove any portion of the URL — enter it precisely as your provider supplied it.
- Enter your username and password — Enter the username and password supplied by your provider. These are case-sensitive — take care with capital letters and any special characters.
- Save and close settings — Select 'OK'. Kodi will connect to the Xtream Codes server and retrieve your channel list.
- Wait for channels to load — As with the M3U method, the first load may take a short time. Navigate to TV > Channels once the notification confirms the list has loaded.
How to set up the EPG (Electronic Programme Guide) in Kodi
The EPG shows what is on now and next for each channel — without it, you will see channel names but no programme schedule. Your IPTV provider may supply a separate XMLTV URL for this.
- Open PVR IPTV Simple Client settings — Go to Add-ons > My add-ons > PVR clients > PVR IPTV Simple Client and select 'Configure'.
- Go to the EPG Settings tab — At the top of the settings panel you will see a row of tabs. Select the 'EPG Settings' tab.
- Enter your XMLTV EPG URL — Locate the 'XMLTV URL' field (or equivalent) and paste the XMLTV URL provided by your IPTV provider. [SCREENSHOT REQUIRED: PVR IPTV Simple Client settings — EPG Settings tab showing XMLTV URL field] If your provider has not supplied an EPG URL, contact them to ask whether one is available.
- Save settings — Select 'OK' to apply.
- Trigger a manual EPG refresh — To force an immediate EPG load, go to the PVR IPTV Simple Client 'Configure' screen again and look for a 'Refresh EPG Data' or 'Update now' button within the EPG Settings tab, or navigate to TV > Guide and open the context menu (press the Menu or 'C' key) to find a refresh option. Allow a few minutes for EPG data to populate after triggering the refresh.
- View the EPG inside Kodi — Navigate to TV > Guide to view the programme schedule grid once data has loaded. If you are using the default Estuary skin, the Guide option appears in the TV submenu in the top navigation bar.
Does the setup differ on a Fire TV Stick, Android TV box, or Windows PC?
The core setup process inside Kodi is identical across devices. The differences are limited to how Kodi is installed and how you navigate the interface.
Good to know
Good to know
Good to know
How to organise and filter your channels after setup
After your channel list loads, Kodi displays channels in the groups defined by your M3U file. Your provider structures these groups — common examples include UK Entertainment, Sports, News, or regional groupings. You cannot rename groups or individual channels within Kodi without editing the M3U file directly; this is a common point of confusion.
To show or hide specific channel groups, navigate to TV > Channels, then open the context menu (press the Menu button on your remote or the 'C' key on a keyboard) and look for a 'Channel groups' or 'Filter' option. Hiding groups you do not use keeps the channel list manageable.
To mark individual channels as favourites, highlight the channel and press the Menu button on your remote or the 'C' key on a keyboard to open the context menu, then select 'Add to favourites'. Your favourites appear in a dedicated section for quick access.
Is using IPTV with Kodi legal in the UK?
Kodi itself is completely legal. It is free, open-source software developed by the Kodi Foundation and widely used as a legitimate media player for locally stored files, official streaming addon services, and licenced content. Owning and using Kodi is not unlawful.
The legality question applies to the IPTV service you connect to Kodi — not to Kodi itself. In the UK, distributing or accessing television channels without the rights holder's authorisation is unlawful under the Copyright, Designs and Patents Act 1988 and related legislation. An IPTV provider must hold the appropriate broadcasting licences and distribution rights for every channel it offers.
If you are unsure whether your IPTV provider is authorised to distribute the channels it offers, contact them directly and ask. Choosing a legitimate, licensed provider is the straightforward way to ensure your use is lawful. This guide does not endorse unlicensed IPTV services.
Is your IPTV provider compatible with Kodi?
Frequently asked questions
Enable PVR IPTV Simple Client from Add-ons > My add-ons > PVR clients in Kodi. Once enabled, open its settings by selecting 'Configure', select the M3U URL option in the General tab, paste in the URL provided by your IPTV provider, and select 'OK'. Kodi will download your channel list automatically. The full process takes around five minutes. If your provider gave you Xtream Codes credentials instead of an M3U URL, select the Xtream Codes API option in the same settings panel and enter your server URL, username, and password.
FAQ
How do I add IPTV to Kodi?
Enable PVR IPTV Simple Client from Add-ons > My add-ons > PVR clients in Kodi. Once enabled, open its settings by selecting 'Configure', select the M3U URL option in the General tab, paste in the URL provided by your IPTV provider, and select 'OK'. Kodi will download your channel list automatically. The full process takes around five minutes. If your provider gave you Xtream Codes credentials instead of an M3U URL, select the Xtream Codes API option in the same settings panel and enter your server URL, username, and password.
Do I need to install a separate addon to use IPTV on Kodi?
No separate addon or third-party repository is required. In Kodi Omega (v21), PVR IPTV Simple Client is bundled with the standard installation and needs only to be enabled from Add-ons > My add-ons > PVR clients — you do not need to download or install anything from an external source.
What is an M3U URL and where do I get one?
An M3U URL is a playlist link that your IPTV provider sends you after you subscribe. It points to a list of stream addresses for the channels included in your subscription. You cannot generate one yourself — it must come from your provider. When setting up PVR IPTV Simple Client, paste this URL exactly as provided into the URL field in the addon's General tab settings. Any error in the URL, including extra spaces, will prevent your channels from loading.
What are Xtream Codes credentials and do I need them?
Xtream Codes credentials are an alternative connection method provided by some IPTV providers. Instead of an M3U URL, you receive a server URL, a username, and a password. PVR IPTV Simple Client in Kodi Omega (v21) supports Xtream Codes API natively — select the Xtream Codes API option in the General tab and enter your credentials. Whether you use M3U or Xtream Codes depends on what your provider supplies — both result in the same channel list inside Kodi.
Why are my channels not showing after I added my M3U URL?
Check that the M3U URL is entered exactly as provided — no extra spaces, missing characters, or line breaks. Test the URL by pasting it into a web browser on a separate device; if the browser cannot load it, the URL may have expired or your subscription may be inactive. If the URL loads in a browser but channels still do not appear in Kodi, disable and re-enable PVR IPTV Simple Client and restart Kodi. If the problem persists, contact your IPTV provider to confirm your account is active and the URL is current.
Why does my EPG not show any programme information?
EPG data requires a separate XMLTV URL from your IPTV provider — it is not part of the M3U playlist. Open PVR IPTV Simple Client settings via 'Configure', go to the EPG Settings tab, and confirm an XMLTV URL is entered. If the field is blank, contact your provider to ask whether an EPG source is included with your subscription. After adding the URL, trigger a manual refresh and allow several minutes for programme data to load. If times appear shifted, check Kodi's timezone setting — this should be set to your local timezone, accounting for BST where applicable.
Can I use Kodi IPTV on a Fire TV Stick?
Yes, Kodi runs on Fire TV Stick devices and the IPTV setup process described in this guide applies in full. As of the time of writing, Kodi is not available on the Amazon Appstore for UK Fire TV Stick users and must be sideloaded using the Downloader app. Once Kodi is installed, navigating to PVR IPTV Simple Client settings and entering your M3U URL or Xtream Codes credentials works identically to other devices. Using a Bluetooth keyboard or the Fire TV remote app can make URL entry easier.
Is Kodi legal to use in the UK?
Kodi itself is completely legal — it is free, open-source software developed by the Kodi Foundation and is used legitimately by millions of people worldwide. Whether using Kodi with a specific IPTV service is lawful depends entirely on that service, not on Kodi. In the UK, accessing TV channels through a provider that does not hold the appropriate rights to distribute them is unlawful. Always use a licensed, authorised IPTV provider. If you are unsure about your provider's licensing status, contact them directly.
Why are my IPTV channels buffering on Kodi?
Buffering is most commonly caused by insufficient internet speed or a congested connection at either your end or your provider's. Test your internet speed on the same device and check whether other streaming services also buffer — if they do, the issue is your connection. If Kodi is the only service that buffers, the problem is likely with the specific IPTV stream. Increasing Kodi's internal cache allocation may help in some cases — This is one possible factor and does not guarantee a resolution.
How do I update or refresh my channel list in Kodi?
Open PVR IPTV Simple Client settings via 'Configure' and look for a manual update or refresh option within the settings panel. Alternatively, disable PVR IPTV Simple Client from Add-ons > My add-ons > PVR clients and then re-enable it — this forces Kodi to re-download your M3U playlist and reload the full channel list. This is the simplest method if your provider has updated your stream URLs.
Related guides
SetupConfiguring MaxConnect on your Smart TV
Get MaxConnect running on Samsung, LG and other Smart TV platforms with this step-by-step guide.
TroubleshootingImprove streaming quality on any connection
Tune your network, device and settings for the sharpest possible picture.
AccountManaging your MaxConnect account and billing
How to update payment details, change plans and manage devices from your account.
Ready to watch?
Choose a plan and start streaming MaxConnect today.