Install Kodi from the official Kodi website or the official store on your device. Do not install a “Kodi build”, a wizard, or a third-party IPTV add-on. We do not support those.
In short
- Use official Kodi only.
- Enable PVR IPTV Simple Client.
- Paste the M3U URL and the XMLTV URL, then restart Kodi.
What you need
- Official Kodi, current version, from kodi.tv or the device’s official store.
- The M3U playlist URL and the XMLTV URL from your welcome message.
- A restart of Kodi after the add-on is configured. The channels appear only after that restart.
Recommended app
Use PVR IPTV Simple Client. The PVR IPTV Simple Client is the official add-on. It is the only Kodi method this guide covers. Other players that also work: VLC .
Step by step
-
Install official Kodi
Install Kodi from the official website or the official app store on your device. Open it once. If you already installed a third-party build, uninstall it before you continue.
-
Enable the PVR IPTV Simple Client
Go to Settings → Add-ons → Install from repository → PVR clients. Select PVR IPTV Simple Client and enable it. When the settings dialog opens, stay on that screen.
-
Set the M3U remote path
Under General, set Location to Remote path (Internet address). Paste your M3U URL into M3U playlist URL. Leave local file empty.
-
Set the XMLTV guide
Set the EPG location to a remote path and paste the XMLTV URL into XMLTV URL. The guide will not show if this field is empty.
-
Restart Kodi
Close Kodi completely and open it again. The TV section appears in the main menu after the restart. Open it and wait for the channel list. A second restart helps if the first one shows an empty TV menu.
If something goes wrong
Swipe sideways to see every column.
| Problem | Cause | Fix |
|---|---|---|
| Buffering | The Wi-Fi drops, or the stream is 4K on a line that cannot hold it. | Kodi buffers when the device is on weak Wi-Fi or when a heavy skin is installed. Use the default skin and a stable connection. Drop to HD if 4K pauses. |
| Black screen | The player opened the stream but the video decoder failed. | Confirm the M3U URL plays in VLC first. If VLC works and Kodi is black, the remote path was left on local file. Switch it to Remote path and restart. |
| Login failed | A username, password or URL was typed with a space or a missing character. | This add-on has no username box. A login error here means the M3U URL is wrong. Paste it again, then restart Kodi. |
| EPG not loading | The guide URL is empty, or the device clock is wrong. | The XMLTV URL must be the remote path, not a file on the device. Restart Kodi after you save it. The first guide download can take several minutes. |
| App not installing | Unknown sources are off, or the store cannot see the app. | If PVR IPTV Simple Client is missing, you are not on official Kodi, or the PVR repository is disabled. Reinstall official Kodi. Do not add a third-party repository to “fix” it. |
| Guide times are an hour out | The EPG offset does not match UK time, or daylight saving has changed. | Set the device timezone to London. In the add-on, leave the offset at 0 unless the guide is still an hour out after the clocks change. |
Kodi questions
Can I use a Kodi build I downloaded?
No. Builds and wizards are unsupported, and many of them are unsafe. Use official Kodi and the PVR IPTV Simple Client only.
Where is the Xtream Codes box?
The official add-on does not have one. Ask us for the M3U and XMLTV URLs. They log in to the same subscription.
The TV menu never appears.
The add-on is not enabled, or Kodi was not restarted. Enable PVR IPTV Simple Client, confirm the URL, then quit Kodi fully and open it again.
Does this work on a Firestick?
Official Kodi from the Amazon Appstore can use this add-on. The Firestick player guide is still the simpler path if you do not already use Kodi.