
How to set up IPTV on Kodi: install the free PVR IPTV Simple Client from Kodi's built-in repository (Settings, Add-ons, Install from repository, PVR clients). Open its settings, set the playlist location to Remote path and paste your provider's M3U link, then add an XMLTV guide link if you have one. Your channels then appear in Kodi's TV section. The add-on reads M3U playlists, not Xtream logins, and Kodi itself includes no channels.
A word on who wrote this. We sell Vivimate, an IPTV subscription, and we don't make Kodi or the add-on. We didn't install Kodi for this page. On November 9, 2026 we read Kodi's own wiki, the add-on's documentation on GitHub, Kodi's release list and its Google Play listing, all linked below. kodi.tv refused our requests that day, so the version facts come from Kodi's wiki and GitHub instead.
What you need before you start
- Kodi on a supported device. Kodi's wiki page about itself listed v21.3 Omega as the stable release on November 9, 2026. Kodi's GitHub releases dated 21.3 to October 31, 2025, and showed Kodi 22 "Piers" only as a release candidate (September 27, 2026).
- An M3U playlist link. This is a single web address that lists every channel. The add-on can also read a file saved on the device.
- A guide link, if your provider has one. The guide is a separate XMLTV file. Without it, channels still play but the guide stays blank.
Kodi doesn't supply any of this. Its Google Play listing states that Kodi "does not contain any content" and that watching illegal content which would otherwise be paid for is "not endorsed or approved by Team Kodi". The listing was last updated on February 5, 2025.
Step by step: install and set up the IPTV Simple Client
These steps follow the paths on the add-on's page in Kodi's wiki and the setting names in its GitHub documentation. Menu wording can shift slightly between Kodi versions and skins.
- Turn off other PVR add-ons.The wiki asks you to disable all PVR add-ons before installing this one, so a TV backend add-on you tried earlier doesn't clash with it.
- Install the add-on. Go to Settings, then Add-ons, then Install from repository, then PVR clients, and choose PVR IPTV Simple Client, then Install.
- Open its settings. Go to Settings, Add-ons, My add-ons, PVR clients, select the add-on and choose Configure.
- Add the playlist. In the General section, set Location to Remote path and paste your link into M3U play list URL. Choose Local path instead if the playlist is a file on the device.
- Add the guide. In the EPG section, set Location to Remote path and paste the link into XMLTV URL.
- Save and open TV. Choose OK, go back to the Home screen and open the TV section. The channel list appears once the add-on has read the playlist.
If a setting in these steps is missing, raise the settings level. The add-on's documentation lists four levels (Basic, Standard, Advanced and Expert) and says hidden settings usually sit at a higher one.
The settings worth changing
| Setting (section) | What it does | When to change it |
|---|---|---|
| Cache M3U at local storage (General) | Keeps a copy of the playlist on the device | Turn on if the list loads slowly each time Kodi starts |
| Auto refresh mode (General) | Disabled, Repeated refresh or Once per day | Once per day suits most lists; caching switches off while it's used |
| Refresh interval (General) | Minutes between refreshes, 120 at most | Only with Repeated refresh |
| Cache XMLTV at local storage (EPG) | Keeps a copy of the guide file | Turn on for a large guide on a slow device |
| Catchup (Catchup) | Plays past programmes from the guide | Only if your provider supports catch-up on that channel |
Since Kodi 20, the documentation says, Kodi can run several pairs of playlist and guide files, one per add-on instance.
Xtream logins, M3U links and catch-up
Many providers hand out an Xtream login: a server URL, a username and a password. The IPTV Simple Client has no field for that. Its documentation describes M3U for channels and XMLTV for the guide, and mentions Xtream only as one way to build catch-up addresses. So for Kodi, ask your provider for the M3U version of your login. Our guide to Xtream Codes logins explains how the two formats relate.
Catch-up works, the documentation says, "if supported by the IPTV provider", and Kodi's optional inputstream add-on adds pausing and rewinding of live channels. The add-on can also list on-demand titles from a playlist as media entries. We haven't checked how any of this behaves with a Vivimate login, so treat it as something to try on a trial. For recording, see our guide to recording IPTV, which covers players with a record button.
When the TV guide is empty or wrong
The guide is where most Kodi setups go wrong. The add-on has to work out which guide rows belong to which channel, and the wiki describes the order it tries.
- Every row is empty. Check the XMLTV URL is filled in and has had time to load the first time.
- Some channels have no guide. Their IDs don't match the guide file. That's a provider-side fix, so tell them which channels.
- Times are off by hours. The playlist can shift the guide with a tvg-shift value, in hours, for one channel or all of them.
- Changes don't show. The documentation's fix is Settings, PVR & Live TV, Guide, Clear cache, or General, Clear cache for channel changes.
For guide problems that aren't specific to Kodi, such as time zones, see our page on a TV guide that won't load.
Kodi on Fire TV, Android TV and Apple TV
- Android TV and Google TV: Kodi is on Google Play, from the Kodi Foundation.
- Fire TV on Fire OS: Kodi's Fire TV page describes sideloading, including through the Downloader app. Our Firestick guide shows how to check your model first.
- Fire TV on Vega OS: Amazon's device specifications list three sticks on Vega OS (Fire TV Stick 4K Select, Fire TV Stick HD from 2026 and Fire TV Stick 4K third generation). These can't sideload, so Kodi won't install.
- Apple TV: searching the US App Store, the only Kodi Foundation app we found is its remote control app. Check the developer line of anything named Kodi, or use the players in our Apple TV guide.
Add-ons: stay inside Kodi's own repository
Kodi's add-on manager page says the Kodi.tv add-on repository comes with Kodi and is maintained by Team Kodi, and that add-ons update automatically by default. Everything on this page comes from there. Other repositories can be added, but Team Kodi doesn't maintain them, and some exist to pull paid channels without the rights. We don't recommend any. Whatever player you use, the legal question sits with the seller of the playlist; our page on whether IPTV is legal explains why.
Is Kodi the right player for you?
Kodi suits people who already use it as a media center and like adjusting settings. It's free and open source, and one remote handles your own films and live TV. If you want an IPTV player that takes a login and shows a guide with less setup, our comparison of IPTV players sets out the alternatives device by device. Whichever you choose, each stream needs roughly 10 Mbps for HD, 20 for Full HD and 30 for 4K.
Using Vivimate in Kodi
A Vivimate login is Xtream, so for Kodi ask support on WhatsApp for an M3U link; a person replies 24/7. We haven't tested Kodi with our service for this page, so use the free 24-hour trial, with no card taken, to check the channel list, the guide and playback in Kodi on your own device. Plans cost $19.99 for 1 month, $29.99 for 3 months, $39.99 for 6 months or $69.99 for 12 months plus 2 free, in US dollars, for one device, with no contract and no auto-renewal. Multi-device prices are on our plans page.
Frequently asked questions
Does Kodi come with IPTV channels?
No. Kodi's Google Play listing says the Kodi version it distributes does not contain any content, and the PVR IPTV Simple Client only reads a playlist you supply. The channels come from whichever provider's M3U link you add.
Can I use an Xtream Codes login in Kodi?
Not as the main login. The add-on's documentation describes an M3U playlist for channels and an XMLTV file for the guide; Xtream appears only as one way to build catch-up addresses. Ask your provider for an M3U link instead. A Vivimate login is Xtream, and support can send an M3U link.
Where is the PVR IPTV Simple Client in Kodi?
Kodi's wiki gives the path Settings, Add-ons, Install from repository, PVR clients, PVR IPTV Simple Client, Install. It sits in Kodi's built-in repository, so you don't need any extra source.
Why is my Kodi TV guide empty?
Usually no guide link was added, or the channel IDs in the playlist don't match those in the guide file. The add-on matches tvg-id first, then tvg-name. After changing a guide setting, clear the guide cache under Settings, PVR & Live TV, Guide.
Which Kodi version should I use?
On November 9, 2026, Kodi's own wiki listed v21.3 Omega as the stable release, and its GitHub showed Kodi 22 "Piers" only as a release candidate. Stay on the stable release for everyday viewing.
Stream Everything with Vivimate
55,000+ live channels · Up to 4K UHD · No contract · From $19.99/month