How to add IPTV to Kodi

Kodi turns a PC, Fire TV or Android box into a full media centre with a proper TV guide. Here is how to add your IPTV subscription using Kodi's official add-on.

Last updated 4 November 2026

Home cinema screen running Kodi with an IPTV TV guide

Before you start

  • Install Kodi from the official source: kodi.tv, Google Play, the Microsoft Store or the Amazon Appstore where available.
  • Have your M3U link and EPG link from your welcome message ready. See M3U playlists.
  • We use PVR IPTV Simple Client, the official add-on from the Kodi team. You do not need any third-party repositories.
Home cinema with ambient lighting and a large screen

Step 1: install PVR IPTV Simple Client

  1. Open Kodi and select the Settings cog.
  2. Choose Add-ons > Install from repository.
  3. Open PVR clients and select PVR IPTV Simple Client.
  4. Select Install (on some platforms it is already installed, so select it and choose Enable).

Step 2: add your playlist

  1. Open the add-on and choose Configure. On newer Kodi versions you may be asked to add a configuration first.
  2. Under General, set Location to Remote path (Internet address).
  3. Paste your M3U playlist URL.
  4. Select OK.

Step 3: add the TV guide

  1. In the same settings, open the EPG tab.
  2. Set Location to Remote path (Internet address).
  3. Paste your XMLTV / EPG URL and select OK.

Step 4: restart and watch

Restart Kodi. A TV option appears on the home screen with your channels and guide. The first load can take a few minutes while Kodi imports the guide.

Friends watching football on a large TV

Keep Kodi clean

Kodi itself is legal, but many third-party “builds” and add-ons stream content without a licence and can carry malware. Stick to official add-ons and your own subscription. Read chipped and fully loaded boxes for why.

Troubleshooting Kodi IPTV

  • No TV option on the home screen: check the add-on is enabled, then restart Kodi.
  • Guide empty: confirm the EPG link, then Settings > PVR & Live TV > Guide > Clear data.
  • Stuttering playback: in Settings > Player > Videos, try enabling or disabling hardware acceleration, and see buffering fixes.

Frequently asked questions

Is Kodi legal?

Yes. Kodi is free, open-source media software. What can be illegal is installing third-party add-ons that stream content without a licence, which is how "Kodi boxes" got a bad name. The official PVR IPTV Simple Client used here is a standard add-on.

Which Kodi version do I need?

Any current Kodi release. Menu names in this guide follow recent versions, and older versions differ slightly.

Why does Kodi not show my channels?

Check that the add-on is enabled, the M3U link is entered in full and Kodi has been restarted. Then look for the TV section on the home screen.

Still stuck?

Send us your device, app and what you see on screen. A screenshot helps us fix it faster.