Kodi is a powerful open-source media center that can handle live IPTV channels through a built-in add-on called PVR IPTV Simple Client. Once configured, your IPTV channels appear in Kodi's Live TV section alongside your local media library, with a full TV guide if you supply an XMLTV EPG URL. This guide walks through the complete setup on Kodi 19 (Matrix) or later, and notes where a dedicated IPTV player might suit you better.
What you need before you start
You need Kodi 19 (Matrix) or later installed on your device, and two URLs from your iptv.domains dashboard:
- M3U playlist URL — the full channel list for Kodi to load.
- XMLTV EPG URL — the TV guide data for the program schedule.
Both are in the Credentials section when you open your stream on the iptv.domains dashboard. They are permanent and never change. If you are not sure what XMLTV is, the EPG and XMLTV guide explains how IPTV TV guides work.
How to set up IPTV on Kodi — step by step
- In Kodi, go to Add-ons from the main menu, then select Install from Repository.
- Open Kodi Add-on Repository → PVR clients → PVR IPTV Simple Client.
- Click Install and wait for the notification that the add-on is ready.
- After installation, click Configure (or navigate to Add-ons → My add-ons → PVR clients → PVR IPTV Simple Client → Configure).
- In the General tab, set Location to Remote path (Internet address).
- In the M3U playlist URL field, paste your M3U URL from your iptv.domains dashboard.
- Switch to the EPG Settings tab. Set XMLTV location to Remote path (Internet address).
- In the XMLTV URL field, paste your XMLTV EPG URL.
- Click OK to save. Kodi will prompt you to restart the PVR manager — click Yes.
- After the restart, a Live TV section appears in the Kodi home screen. Select it to browse channels by category and view the on-screen TV guide.
Browsing channels and the TV guide in Kodi
Once Live TV is active, you can browse channels in a grid view and open the full TV guide (EPG) to see what is on now and coming up. Channels are grouped by the categories in your playlist — the same categories you can reorder and rename using the iptv.domains playlist editor.
To jump directly to a channel, press C on a keyboard or the info/options button on a remote to open the context menu, where you can add channels to favorites.
Troubleshooting common issues
Channel list not loading
If Live TV shows no channels, first confirm the M3U URL is correct by pasting it into a browser — it should begin downloading a file. Then make sure the PVR IPTV Simple Client is shown as enabled in Add-ons → My add-ons → PVR clients. Restart Kodi fully (not just the PVR) if the list still does not appear.
EPG not showing programme data
Kodi caches EPG data and may take 5–15 minutes to fully populate the guide after setup. If the guide is still empty, go to Settings → PVR & Live TV → Guide → Force EPG cache refresh, then restart Kodi. Also verify the XMLTV URL returns data when you open it in a browser.
Channels buffering or not playing
Kodi's default media player is adequate for most streams, but you can install the InputStream Adaptive add-on to improve HLS (m3u8) stream compatibility. It ships with Kodi 19+ and can be enabled in Add-ons → My add-ons → VideoPlayer InputStream.
Scenario: Setting up IPTV on a Kodi home theatre PC
Elena runs a dedicated Kodi HTPC connected to her living-room TV. She wants her IPTV channels integrated into Kodi so she can switch between live TV and her local movie library without changing input or app. She follows the steps above, pastes her iptv.domains M3U and XMLTV URLs, and restarts the PVR. Ten minutes later, Live TV appears in the Kodi home screen. She can browse channels in a grid, see what is on now in the guide, and jump straight from a live channel to a film in her library — all within the same Kodi interface.
Because her iptv.domains URL is permanent, she has not had to touch the Kodi config in months — even after switching providers once on the dashboard.
Does Kodi support Xtream Codes login?
PVR IPTV Simple Client only supports M3U playlist URLs, not the Xtream Codes server URL + username + password login format. For Xtream login in Kodi, a third-party add-on is needed — check the Kodi community forums for current recommendations, as these evolve over time. Alternatively, your iptv.domains M3U URL carries all the same content as the Xtream login, so PVR IPTV Simple Client gives you everything without the need for an extra add-on. The Xtream Codes setup guide explains the difference in more detail.
When a dedicated IPTV player is simpler
Kodi is a flexible platform but it asks for more configuration than a purpose-built IPTV app. If you are setting up on Android TV, Fire TV or a phone, apps like TiViMate, Chillio or IPTV Smarters Pro take less than five minutes from install to playing channels — they support Xtream Codes login directly, load EPG automatically, and are optimised for remote-control navigation. See the best IPTV players guide for a full breakdown by platform.
iptv.domains is also building Demivo, a native IPTV player designed to pair directly with your account. It is not yet released, but is coming soon with built-in EPG and channel management.
Keeping your Kodi setup maintenance-free
The main advantage of using a permanent middleware URL from iptv.domains is that your Kodi configuration never needs updating. If your underlying provider changes URLs, servers or credentials, you update that once on the iptv.domains dashboard — Kodi's M3U URL stays exactly the same. No re-configuring, no re-entering credentials on each device.