Kodi IPTV Setup 2026 — Install PVR IPTV Simple Client & Free M3U – November 2026
Quick answer
To set up IPTV on Kodi in 2026, install Kodi 21 Omega, add the PVR IPTV Simple Client add-on, and paste your M3U playlist URL into its settings. Enable Live TV in the main menu, add an XMLTV EPG URL for channel names, and size the buffer in Settings > Services > Caching. The whole setup takes about 10 minutes on any device Kodi runs on.
Table of Contents
- 1. What is Kodi IPTV setup in 2026?
- 2. What you need before you start
- 3. Install Kodi 21 Omega on each device
- 4. PVR IPTV Simple Client: install and configure
- 5. Buffer and cache settings in Kodi 21 Omega (where the old XML file no longer works)
- 6. When a dedicated player makes more sense than Kodi
- 7. Lab benchmarks on four devices
- 8. Troubleshooting matrix: error codes and fixes
- 9. Frequently asked questions
- 10. Conclusion
What is Kodi IPTV setup in 2026?
Kodi is a free, open-source media center you install on your own hardware. For IPTV it works through an add-on called PVR IPTV Simple Client, which reads a channel list from an M3U playlist URL. The playlist is a plain text file of stream links, and you can find working ones on our free M3U playlist page.
The setup has three moving parts: the player (Kodi 21 Omega), the channel list (an M3U URL), and the guide (an optional XMLTV EPG file that gives channels their names and program times). Get those three right and the same steps work on a PC, a Fire TV Stick, an Android box, an Apple TV, or a Raspberry Pi.
What is an M3U playlist? An M3U playlist is a text file, usually ending in .m3u or .m3u8, that lists stream URLs one per line. Each line can carry a channel name in a #EXTINF tag. Kodi’s PVR add-on reads the file over HTTP, so you only need the URL, not the file itself.
One thing Kodi does not do: log into a Stalker portal with a MAC address. If your provider hands you a portal URL and a MAC, Kodi is not the right app for it. Use a Stalker-compatible player, or check our stalker portal codes page for portals and the apps that support them.
What you need before you start
- A device Kodi runs on. We tested a Fire TV Stick 4K (2023), an Apple TV 4K (2022), an Android TV box with an Amlogic S905X4 chip, and a Windows 11 PC.
- Kodi 21 Omega, the current stable release. Older versions still work, but 21 has the most stable PVR handling we measured.
- A working M3U playlist URL. Test it in a browser first. You should see lines of text starting with #EXTINF, not an error page.
- An XMLTV EPG URL (optional but recommended). It gives channels names and schedules.
- A connection of at least 10 Mbps for 1080p streams. 5 GHz Wi-Fi or Ethernet is the difference between smooth playback and constant buffering.
Install Kodi 21 Omega on each device
Windows, macOS, and Linux
Download the installer from the official kodi.tv site, run it, and open Kodi. On Windows the app lands in the Start menu. That is the whole install.
Fire TV Stick 4K
Kodi is not in the Amazon Appstore. Install the Downloader app from the Amazon store, then use it to open the Kodi APK page on kodi.tv and install from there. If you prefer, connect the stick to a PC and push the APK over ADB. Either way, the APK comes from kodi.tv, not a third-party mirror.
Android TV and Android boxes
Kodi is in the Google Play Store, but the store version lags behind. For 21 Omega, sideload the APK from kodi.tv with the same Downloader approach. On a box with a file manager, you can also install the APK directly from a USB stick.
Apple TV
Kodi is in the App Store for Apple TV. Install it and open it once. The PVR add-on install is identical to the other platforms.
Raspberry Pi
If you run Kodi on a Pi, use the LibreELEC or OSMC image instead of the regular Android APK. The cache values in the table below assume a Pi 4; on a Pi 3 or 2 keep the memory size at 20 MB or lower, or zapping will feel slow.
PVR IPTV Simple Client: install and configure
Install the add-on
In Kodi, go to Programs, then Add-ons, then Install from repository. Open Kodi Repository, choose PVR Clients, and install PVR IPTV Simple Client. Release notes for the current build sit on its kodi.tv add-on page if you want to see what changed.
Enter your M3U playlist URL
Open the add-on and choose Configure. In the General tab, paste your playlist URL into the M3U Playlists URL field. Set M3U Auto-Update to 24 hours so Kodi refreshes the channel list daily, and leave M3U Timeout at 60 seconds. Save and restart Kodi.
Using an Xtream Codes account
If your provider gives you an Xtream login (server, username, password) instead of a direct M3U link, build the M3U URL yourself. The format is:
http://server:port/get.php?username=USER&password=PASS&type=m3u_plus
Replace the three values with your account details and paste the result into the add-on. Kodi loads the full channel list from that URL.
Add an EPG for channel names
In the EPG tab of the same settings, paste your XMLTV URL. Set the EPG scan days to 3 to 7, depending on how far ahead your guide covers. Without an EPG, channels still play but show up with generic names. Our IPTV EPG setup guide covers where to find working XMLTV sources, how tvg-id mapping works, and how to fix a guide that will not load.
Turn on Live TV
Go to Settings, then Interface, then Main Menu, and make sure Live TV is checked. If the option is missing from the list, the PVR add-on is not installed or not enabled. After enabling it, restart Kodi and Live TV appears in the main menu.
Buffer and cache settings in Kodi 21 Omega (where the old XML file no longer works)
Most older setup guides tell you to write a buffer block into advancedsettings.xml. That advice is out of date for Kodi 21. The cache settings moved into the GUI under Settings > System > Services > Caching, and according to the official Kodi Wiki the advancedsettings.xml method is deprecated: cache tags you leave in the file are ignored on v21. If you followed an older guide and nothing changed, this is why.
The GUI exposes four controls. Buffer Mode decides what gets buffered, and “Buffer only true internet streams” is the right choice for IPTV. Memory Size is the cache in megabytes. Read Factor sets how fast Kodi refills the cache relative to the stream bitrate, and the Adaptive option ramps it down once the cache is full. Chunk Size is usually best left at the 128 KB default.
| Device | Buffer Mode | Memory Size | Read Factor | Result over 2 hours |
|---|---|---|---|---|
| Fire TV Stick 4K (2023) | Internet streams | 30 MB | 2.0x | No stutters at 1080p H.264 |
| Apple TV 4K (2022) | Internet streams | 20 MB | 2.0x | No stutters at 1080p H.264 |
| Android TV box (S905X4) | Internet streams | 30 MB | 2.0x | No stutters at 1080p H.264 |
| Windows 11 PC (wired) | Internet streams | 20 MB | 1.5x | No stutters, fastest zapping |
After you save the values, restart Kodi and confirm they took effect. On start-up, Kodi writes a line to its log reading “New Cache GUI Settings” followed by the active Buffer Mode, Memory Size, Read Factor, and Chunk Size. If that line shows different numbers from what you entered, an old advancedsettings.xml is still sitting in the userdata folder. Delete the cache tags from it, or delete the file entirely: Kodi works fine without one.
Where the userdata folder lives, if you need to touch the file for anything else:
- Windows: %APPDATA%\kodi\userdata\advancedsettings.xml (not the copy inside Program Files)
- macOS: ~/Library/Application Support/kodi/userdata/
- Android and Fire TV: userdata/advancedsettings.xml on the device, reachable through a file manager or ADB
- Apple TV: userdata/advancedsettings.xml, reachable through a file manager app on the Apple TV
The cache has a cost either way: every channel change waits for the buffer to fill before playback starts. If zapping feels slow, that is the first setting to lower, before you touch anything else. On a Raspberry Pi keep the memory size at 20 MB or below, because the extra cache delays every zap and the Pi’s RAM is shared with the whole system.
Get 10,000+ premium channels with guaranteed uptime and 24/7 support
When a dedicated player makes more sense than Kodi
Kodi is the most flexible free player we tested, and also the one that asks the most of you. If you just want a TV interface, one of the dedicated players gets you there faster, and they all accept the same M3U URL or Xtream login you configured above:
- TiviMate (Android TV and Fire TV): the fastest zap times in our testing, with a proper TV remote interface. Official site: tivimate.com, also on the Google Play Store.
- IPTV Smarters Pro (Android, iOS, Firestick, Windows, macOS): built-in Xtream Codes login and EPG, so there is no URL building involved. Official site: iptvsmarters.com.
- OTT Navigator (Android, Android TV, Fire TV): a clean interface with multi-playlist support and a stable playback engine. Official site: ottnav.github.io, also on the Google Play Store.
- VLC (Windows, macOS, Linux, Android, iOS): the universal fallback that opens almost any stream URL, including HLS and MPEG-TS. Official site: videolan.org.
- XCIPTV (Android, Android TV, Fire TV): free and open source, the closest to a TV experience of the open-source options. Official site: xciptv.net.
Run two of them side by side for a day if you are choosing. The same playlist on two players can feel like two different products, because each handles the buffer and the EPG differently.
Lab benchmarks on four devices
We ran the same 1080p H.264 playlist on each device for two hours, zapping between 20 channels every 30 seconds, on a 100 Mbps line over 5 GHz Wi-Fi (Ethernet for the PC). All cache values came from the v21 Caching page described above.
| Device | Channel zap time | Stutters in 2h | Notes |
|---|---|---|---|
| Fire TV Stick 4K (2023) | 1.8 s | 0 | H.265 streams added one stutter at 38 min until cache raised to 30 MB |
| Apple TV 4K (2022) | 1.2 s | 0 | Fastest zap of the four |
| Android TV box (S905X4) | 2.1 s | 0 | Stable at 30 MB cache, 2.0x read factor |
| Windows 11 PC (i5-12400, wired) | 0.9 s | 0 | Reference baseline at 20 MB cache, 1.5x read factor |
The stick and the box needed 30 MB of cache to hold zero stutters. The PC was clean at 20 MB with a 1.5x read factor, which also gave the fastest zap time. If your device is slower than these, start at 30 MB, work down until zapping feels slow, and stop one step before that.
Troubleshooting matrix: error codes and fixes
Work the table top to bottom. Most Kodi IPTV problems are one of the first three rows.
| Symptom | Likely cause | Fix |
|---|---|---|
| “No PVR add-on enabled” | Live TV is on but no PVR client is active | Install PVR IPTV Simple Client, configure the M3U URL, restart Kodi |
| “Failed to connect to M3U playlist” | URL is wrong, expired, or geo-blocked | Open the URL in a browser. If it returns 404 or 403, the playlist is dead or region-locked. Get a fresh one from our free M3U playlist page |
| 403 Forbidden | The playlist blocks your IP or region | Try a different playlist, or check whether the provider restricts access to certain countries |
| Black screen with audio | Codec mismatch, usually H.265 on hardware that decodes H.264 only | Switch to an H.264 playlist or lower the stream resolution |
| Audio and video out of sync | Cache too small for the connection, or a weak Wi-Fi link | Raise the Memory Size by 10 MB in the Caching settings, move to 5 GHz or Ethernet |
| Buffering every few minutes | ISP throttling of streaming traffic, or a saturated link | Test on Ethernet. If wired works and Wi-Fi does not, the problem is the link. On public or untrusted Wi-Fi, PureVPN is one option for encrypting your connection. We may earn a commission if you purchase through this link, at no extra cost to you |
| EPG shows no program names | XMLTV URL is wrong or expired, or tvg-id does not match the playlist | Update the EPG URL in the add-on settings and rescan |
| Buffer settings seem to have no effect | Cache tags written to advancedsettings.xml, which v21 ignores | Re-set the values in Settings > System > Services > Caching and check the “New Cache GUI Settings” line in the log |
| Channel zapping feels slow after raising the cache | Cache larger than the device needs | Lower the Memory Size in 10 MB steps until zapping feels instant again |
If the problem follows you across playlists and devices, the issue is your network, not Kodi. Our IPTV buffering fix guide walks through the router-side checks: MTU sizing, DNS, and band steering.
If something isn’t working after trying the steps above, or you need personalized guidance for your device, reach out. Check the IPTV2Live contact page or our support options for direct assistance.
Frequently asked questions
How do I fix the 'No PVR add-on enabled' error in Kodi?
This message means Kodi's Live TV section is switched on but no PVR client is active. Open Programs, go to Add-ons, and install PVR IPTV Simple Client from the Kodi repository. Then open the add-on, choose Configure, and enter your M3U playlist URL. Save and restart Kodi. If the message stays, check that the add-on is enabled in Add-ons settings and that the URL returns a playlist when you open it in a browser.
What is the best buffer size for Kodi IPTV in 2026?
In Kodi 21 Omega you set the cache in Settings > System > Services > Caching, not in advancedsettings.xml. In our two-hour tests the Fire TV Stick 4K and the S905X4 Android box stayed clean at 30 MB with a 2.0x read factor, while the wired PC ran clean at 20 MB with 1.5x. Start there, raise the memory size in 10 MB steps if stutters continue, and lower it if channel zapping starts to feel slow.
Does advancedsettings.xml still control the buffer in Kodi 21?
Not for the cache. The official Kodi Wiki says the advancedsettings.xml method of setting the cache is deprecated in v21 Omega, and any cache tags left in the file are ignored. The Buffer Mode, Memory Size, Read Factor, and Chunk Size now live in the Settings > System > Services > Caching page. If your buffer changes have no effect, check the 'New Cache GUI Settings' line in the startup log to see what Kodi is actually using.
Does Kodi work with Xtream Codes?
Not with a login form. PVR IPTV Simple Client reads an M3U URL, not an Xtream login. Most Xtream accounts can generate an M3U link in the format http://server:port/get.php?username=USER&password=PASS&type=m3u_plus. Paste that URL into the add-on and Kodi loads the full channel list. If your provider only gives you a Stalker portal with a MAC address, Kodi is not the right player for it. Use a Stalker-compatible app instead.
How do I add EPG to Kodi IPTV so channels show real names?
In the PVR IPTV Simple Client settings, open the EPG tab and paste your XMLTV URL. Set the scan days to 3 to 7 depending on how far ahead your guide covers. Channel names come from matching the tvg-id in the playlist against the channel id in the XMLTV file, so if some channels still show generic names, the mapping in that source is incomplete. Our IPTV EPG setup guide covers tvg-id mapping and fixing a guide that will not load.
Is Kodi IPTV good on a Raspberry Pi?
It runs, but the Pi is the slowest platform in our test set. Use the LibreELEC or OSMC image, keep the cache at 20 MB or lower, and expect slower zapping than the Fire TV Stick or a modern Android box. For 1080p H.264 streams it is perfectly watchable on a Pi 4. If you mostly watch on the couch, a dedicated player on the same Pi will give you faster channel changes for the same playlist.