HomeGuides › How to Set Up IPTV on Kodi

How to Set Up IPTV on Kodi

Updated 2026-06-14 · 7 min read

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.

TL;DR: Add-ons → PVR IPTV Simple Client → Configure → paste your M3U URL and XMLTV EPG URL → restart the PVR → Live TV appears in the Kodi menu. Takes about ten minutes.

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

  1. In Kodi, go to Add-ons from the main menu, then select Install from Repository.
  2. Open Kodi Add-on RepositoryPVR clientsPVR IPTV Simple Client.
  3. Click Install and wait for the notification that the add-on is ready.
  4. After installation, click Configure (or navigate to Add-ons → My add-ons → PVR clients → PVR IPTV Simple Client → Configure).
  5. In the General tab, set Location to Remote path (Internet address).
  6. In the M3U playlist URL field, paste your M3U URL from your iptv.domains dashboard.
  7. Switch to the EPG Settings tab. Set XMLTV location to Remote path (Internet address).
  8. In the XMLTV URL field, paste your XMLTV EPG URL.
  9. Click OK to save. Kodi will prompt you to restart the PVR manager — click Yes.
  10. 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.
Tip: The first time Kodi loads a large channel list and EPG, it can take several minutes. Leave Kodi open and wait for the "EPG updated" notification before browsing — the guide will be incomplete until the download finishes.

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.

Example

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.

Frequently asked questions

Which add-on should I use for IPTV in Kodi?

The built-in PVR IPTV Simple Client is the standard choice — no third-party repository needed. It is included with Kodi 19 (Matrix) and later and supports M3U playlists plus XMLTV EPG out of the box.

How do I add a TV guide (EPG) to IPTV in Kodi?

In the PVR IPTV Simple Client settings, open the EPG Settings tab, set XMLTV location to Remote path, and paste your XMLTV EPG URL. Kodi will download and display the guide data after restarting the PVR manager. Your iptv.domains XMLTV URL is in the Credentials section of your dashboard.

Does PVR IPTV Simple Client support Xtream Codes login?

No. PVR IPTV Simple Client uses M3U playlist URLs only, not the Xtream Codes server URL + username + password format. If you want Xtream login in Kodi, a third-party add-on is required — check the Kodi community forums for current options.

My channel list is empty in Kodi after setup — what should I check?

First confirm the M3U URL is correct by pasting it into a browser — it should start downloading a file. Then check that the PVR client is enabled (Add-ons → My add-ons → PVR clients). Finally, try restarting Kodi fully after saving the settings; sometimes the PVR manager needs a complete restart to pick up a new playlist.

Can I use Kodi IPTV on a Fire Stick or Android TV?

Yes. Kodi runs on Fire TV, Android TV and most Android devices. The setup steps are identical. However, apps like TiViMate and Chillio that are purpose-built for IPTV on those platforms are generally easier to navigate and require less configuration.

Stop re-entering IPTV credentials on every device

iptv.domains gives you one permanent URL, automatic failover, and a full playlist & EPG editor. Free trial, no card required.

Start your free trial →

Related guides