Kodi IPTV works through an official add-on called PVR IPTV Simple Client. Kodi itself is a free, open-source media centre with no channels of its own; the add-on teaches it to read an M3U playlist and an XMLTV guide, after which live channels appear under TV in Kodi’s main menu. You install the add-on from Kodi’s own repository, paste your provider’s M3U link and guide address into its settings, and restart. This guide covers those steps, then what a service should offer to work well with Kodi.

Kodi has a loyal following among Canadian tinkerers, especially people who already run it on a home theatre PC or an Android box for their own music and video files. Adding live TV to that setup is straightforward, provided you stick to the official add-on.

Where Kodi Runs

Kodi is published by the XBMC Foundation and is available for Windows, macOS, Linux and Android, including Android TV and Google TV devices through Google Play. It is not in the Apple App Store or the Amazon Appstore, so for Apple TV and Fire TV check the official Kodi site and wiki for what they currently document before trying anything. Samsung and LG televisions do not run Kodi.

On Fire TV in particular, only follow a route the Kodi project itself documents. Our Downloader app guide explains why we take that line with every app.

What PVR IPTV Simple Client Does

Kodi separates its live TV features from the source of the channels. A PVR client add-on supplies the source, and Kodi provides the guide grid, channel switching and, where supported, recording. PVR IPTV Simple Client is the client for M3U playlists. It reads the channel list from your M3U link and, if you give it one, programme data from an XMLTV address.

  • Channels: from an M3U playlist, either a web address or a file on the device.
  • Guide: from an XMLTV source, again a web address or a local file.
  • Logos: from the playlist itself, or a folder or address you set.
  • Cost: free, maintained alongside Kodi in the official add-on repository.

Kodi IPTV Setup, Step by Step

Menu names below follow recent Kodi versions. Older versions use similar wording in slightly different places.

  1. Open Kodi and select the gear icon to reach Settings, then Add-ons.
  2. Open Install from repository and go into the PVR clients category.
  3. Pick PVR IPTV Simple Client from the list, then Install.
  4. Once installed, open the add-on again and choose Configure.
  5. Under the General settings, set the M3U playlist location to a remote path (internet address) and paste your M3U link.
  6. Under the EPG settings, set the XMLTV location to a remote path and paste your guide address, if your provider supplied one.
  7. Confirm, make sure the add-on is enabled, then restart Kodi.
  8. Open TV from the main menu. Channels load first; the guide fills in as Kodi imports it.

On some Linux distributions the add-on comes as a separate system package rather than through Kodi’s repository. If PVR clients is empty on Linux, check your distribution’s package manager.

Kodi M3U Links and Xtream Details

Simple Client wants an M3U address. If your provider gave you Xtream values only, ask for the M3U form of the same playlist rather than trying to build one yourself. Our Xtream login vs M3U link explainer shows how the two formats relate.

Paste the link on a device with a keyboard if you can. On an Android box, Kodi’s on-screen keyboard is workable but slow, and a single wrong character stops the playlist loading.

Getting the Kodi Live TV Guide Right

Most guide problems on Kodi have three causes. First, no XMLTV address was entered, so Kodi has channels but nothing to show in the grid. Second, the channel names in the playlist do not match the IDs in the guide data; providers usually handle this, but it is worth asking. Third, time: Canada spans six time zones, and if the device clock is wrong, every programme appears shifted. Fix the system time zone before adjusting anything in the add-on.

After changing guide settings, Kodi may keep showing old data. In the PVR and Live TV settings there is an option to clear the guide data so it reimports. Use it after any address change.

Living With Kodi Live TV Day to Day

Once channels load, a little organizing makes Kodi much nicer to use with a remote. Kodi has its own channel manager under the live TV settings, where you can hide channels you never watch and change their order. It also lets you build channel groups, so a household might keep one group for news, one for sports and one for the kids, and switch between them from the TV screen.

The guide view in Kodi can show a grid or a list, and you can jump straight to a programme’s channel from either. If the grid feels crowded on a smaller TV, the list view is easier to read from the sofa. These settings are part of Kodi itself, so they stay the same even if you later replace the playlist address in the add-on.

One caution: Kodi’s skin and settings menus differ between versions and between the skins people install. If a menu named here does not match your screen, look for the closest equivalent under Settings, then PVR and Live TV.

Keeping a Kodi IPTV Setup Healthy

  • Install add-ons from Kodi’s official repository. Third-party “builds” and repositories bundle unknown code and are a common source of crashes.
  • Update Kodi from the same place you installed it, such as Google Play or the official site.
  • If channels stop loading after a provider change, replace the M3U address in Simple Client’s settings rather than adding a second instance.
  • Keep a copy of your M3U and guide addresses in a password manager; you will need them after any reinstall.

Best IPTV for Kodi: What to Look For in a Service

Rather than naming providers, here is what makes a subscription work well with Kodi specifically.

  • An M3U playlist link, not only an Xtream login, since Simple Client reads M3U.
  • A separate XMLTV guide address, so the TV section has a working grid.
  • Channel IDs in the playlist that match the guide data, which saves you mapping channels by hand.
  • Support that will answer questions about playlist and guide formats rather than only app-specific ones.
  • Clear plan terms, so you know when the playlist link will stop working and how to renew.

If you use Kodi with AlohaStream8K and the playlist or guide will not load, message us and we will check your login details. Plans are listed on our pricing page.

Kodi or a Dedicated Player?

Kodi rewards people who enjoy configuring things. If you would rather install an app, sign in and watch, a dedicated IPTV player is quicker to set up, especially on a TV remote. Our guide to choosing an IPTV player compares the options. If you want us to activate the player too, IBO Player Pro and TvMate Pro are described on the Apps page, and setup steps for each device are on the installation page.

Comparing other free or developer-licensed players? See our articles on XCIPTV and Duplecast.

Frequently Asked Questions

Does Kodi include any live channels?

No. Kodi is a media centre with no content of its own. Live TV comes from the playlist you add through PVR IPTV Simple Client.

Where is the M3U setting in Kodi?

In the PVR IPTV Simple Client add-on: open it under Add-ons, choose Configure, and look in the General section for the M3U playlist location.

Why are my Kodi channels there but the guide empty?

Usually because no XMLTV address was entered, or the device time zone is wrong. Add the guide address, fix the clock, then clear the guide data so it reimports.

Can I use Kodi on my Samsung or LG TV?

Not directly. Kodi does not run on Tizen or webOS. Use a Kodi-capable device such as a PC or Android TV box, or a player from your TV’s store.