Do not install a Kodi build, a wizard, or a repository you were sent in a forum post. Those are unsupported, and this subscription does not need them.
Updated
At a glance
- Devices
- Kodi on any supported device
- Price
- Free
- Login
- M3U, XMLTV
- Our view
- Very good. Editorial only, not a review score.
Best for. People who already use official Kodi and want live TV in the TV menu.
Skip it when. A first IPTV install on a Firestick. The Firestick guide with TiviMate or Smarters is shorter and safer.
Official download: Get official Kodi from kodi.tv
Good and less good
Works well
- It is the add-on Kodi includes for this job.
- M3U and XMLTV are separate, so the guide can be refreshed on its own.
- It works on any device that runs official Kodi.
Watch out for
- You must restart Kodi before the TV menu appears.
- There is no Xtream Codes box.
- Third-party builds often hide or replace this add-on.
Set it up
Choose a device
Install Kodi from kodi.tv or the official store. Go to Settings → Add-ons → Install from repository → PVR clients and enable PVR IPTV Simple Client.
Set the M3U location to Remote path and paste the playlist URL. Set the EPG location to a remote path and paste the XMLTV URL. Leave local file blank.
Quit Kodi completely and open it again. The TV item appears on the home screen after that restart. If it is missing, check the add-on is enabled and restart once more.
Login and playback settings
This add-on does not accept a username and password in separate boxes. The M3U URL and the XMLTV URL are the login. Ask us for both if the welcome message only listed Xtream fields. Do not add another PVR client to “get Xtream working”.
- Buffer. Use the default skin and a stable network. A heavy skin makes buffering worse. HD is the fallback when 4K pauses.
- Decoder. Kodi’s player settings can stay on default. A black screen with a working VLC test means the remote path was not selected.
- EPG interval. The first XMLTV download can take several minutes. Later updates follow the add-on’s guide settings. Do not sit and refresh every minute.
- UK time. Device timezone London. Leave the add-on offset at 0 unless the guide is still wrong after the clocks change and a restart.
If something goes wrong
Swipe sideways to see every column.
| Problem | Cause | Fix |
|---|---|---|
| No TV menu | Kodi was not fully quit, or the add-on is disabled. | Enable PVR IPTV Simple Client, confirm both URLs, then quit Kodi and open it again. |
| Add-on missing | This is not official Kodi, or a build removed the PVR repository. | Uninstall that build and install Kodi from kodi.tv. Do not add a third-party repo to replace it. |
| Guide empty | The XMLTV field is blank or still set to a local file. | Switch it to a remote path, paste the URL, and restart. |
PVR IPTV Simple Client questions
Can I use a Kodi build from a downloader code?
No. Builds and wizards are outside this guide. Use official Kodi only.
Where do I type the Xtream password?
You don’t. Ask for the M3U and XMLTV URLs. They use the same subscription.
Does this work on a Firestick?
Official Kodi from the Amazon Appstore can run the add-on. Most people should still use the Firestick player guide instead.
Will you support a different PVR add-on?
No. PVR IPTV Simple Client is the only Kodi method we document.