The PVR IPTV Simple Client is Kodi’s official live TV plugin that transforms your media center into a fully functional television system. It requires an M3U playlist URL (from a paid IPTV provider or free source) to populate channels and an optional XMLTV EPG URL for program guides.
⚠️ ADD-ON STATUS DISCLAIMER
Current Add-on Status: 🟢 WORKING (Official Kodi Repository)
Last Verified: August 10, 2026
Important Note: The PVR IPTV Simple Client (also listed simply as “IPTV Simple Client” in some Kodi versions) is an official Kodi add-on installed directly from Kodi’s built-in repository. No “Unknown Sources” activation is required—it’s already available in every Kodi installation.
Kodi 22 “Piers” Compatibility: ⚠️ The add-on works on Kodi 22 “Piers” but has known compatibility issues with
inputstream.ffmpegdirecton some platforms (particularly Windows and Android). If you encounter dependency errors, Kodi 21 “Omega” is recommended for stability until these issues are resolved.If you’re looking for alternatives (e.g., Xtream Codes support, additional features), consider:
- XCIPTV Player – Supports both Xtream Codes API and M3U playlists with PVR integration
- pvr.satip – For SAT>IP servers that automatically discover M3U and EPG data on your network
- Dispatcharr – A self-hosted proxy/manager for M3U, Xtream Codes, and EPG that works with pvr.iptvsimple
What Is the PVR IPTV Simple Client?
The PVR IPTV Simple Client is Kodi’s official Personal Video Recorder (PVR) client for IPTV. Think of it this way—Kodi is the TV set, and PVR IPTV Simple Client is the antenna or cable box that brings channels into it.
Unlike most third-party Kodi add-ons that come with pre-packaged content, this plugin doesn’t include any channels by default. Instead, it acts as a bridge between Kodi and your IPTV source. You provide an M3U playlist (a simple text file containing channel names and stream URLs), and the plugin populates Kodi with live TV channels automatically.
Who is this for?
- Cord-cutters looking to replace traditional cable TV
- IPTV subscribers who want a premium viewing interface
- Anyone with access to free M3U playlists who wants to watch live TV on Kodi
Value Proposition:
- ✅ Official Kodi add-on – No sketchy zip files or third-party repositories required
- ✅ Complete TV experience – Full channel list, electronic program guide (EPG), channel categories
- ✅ Free and open-source – Licensed under GPL-2.0-or-later
- ✅ Cross-platform – Works on Android TV, Fire Stick, Windows, Mac, Linux, and Raspberry Pi
📋 “No-Click” Quick-Reference Cheatsheet
For experienced users—skip the reading and install now.
| Item | Details |
|---|---|
| Add-on Name | PVR IPTV Simple Client (also listed as “IPTV Simple Client”) |
| Repository | Official Kodi Repository (built-in) |
| Add-on ID | pvr.iptvsimple |
| Current Version | 21.11.0 (Kodi 21 Omega) / 22.6.4 (Kodi 22 Piers) |
| Installation Path | Add-ons → Install from repository → PVR clients → IPTV Simple Client |
| M3U Location | Local path OR Remote URL (HTTP/HTTPS) |
| EPG Location | XMLTV URL (provided by your IPTV service) |
| Current Status | 🟢 Working |
| Last Verified | August 10, 2026 |
| Unknown Sources Required? | ❌ NO – installs from official repository |
| Kodi 22 Compatibility | ⚠️ Yes, but with potential inputstream.ffmpegdirect dependency issues |
| XMLTV Compression Support | ✅ Gzip and XZ compression supported |
| Multi-Instance Support | ✅ Yes (Kodi 20+) – manage multiple IPTV providers |
| Catchup/Archive Streams | ✅ Yes (if provider supports it) |
| VPN Requirement | ⚠️ Recommended – Protects your privacy and prevents ISP throttling when streaming |
🟢 PVR IPTV Simple Client Status Report & Testing Log
| Metric | Status |
|---|---|
| Current Add-on Version | 21.11.0 (Omega) / 22.6.4 (Piers) |
| Supported Kodi Versions | Kodi 19 (Matrix), 20 (Nexus), 21 (Omega), 22 (Piers – with caveats) |
| Stream Quality | Dependent on M3U source – up to 4K if provider supports it |
| Tested Hardware | Amazon Fire TV Stick 4K Max (Fire OS 8), Chromecast with Google TV, NVIDIA Shield, Windows PC, Raspberry Pi |
| EPG Support | ✅ Full XMLTV integration (Gzip/XZ compression supported) |
| Multi-Instance Support | ✅ Yes (Kodi 20+) – manage multiple IPTV providers |
| Time-Shift/Catchup Support | ✅ Yes (if provider supports it) |
| VPN Requirement | ⚠️ Recommended – Protects your privacy and prevents ISP throttling when streaming |
📥 Installation Tutorial: Add an M3U File to Kodi
Prerequisite: Check Your Kodi Version
PVR IPTV Simple Client requires Kodi 19 (Matrix) or higher. Kodi 20 (Nexus) or 21 (Omega) is recommended for multi-instance support and stability.
⚠️ Kodi 22 “Piers” Users: While the add-on has dedicated builds for Kodi 22 (version 22.6.4), some users report dependency issues with
inputstream.ffmpegdirecton Windows and Android platforms. If you encounter a “Dependency can’t be Satisfied” error, consider using Kodi 21 “Omega” for a stable experience.
To check your version: Open Kodi → Settings (gear icon) → System Information. If you need to update Kodi to the latest version, we have a complete guide.
Part 1: Install PVR IPTV Simple Client
No “Unknown Sources” activation is required – this add-on comes from the official Kodi repository.
- Open Kodi and navigate to Add-ons from the main menu.
- Click the open box icon (Add-on browser) in the top-left corner.
- Select Install from repository.
- Choose PVR clients from the list.
- Find and select IPTV Simple Client (also listed as “PVR IPTV Simple Client”).
- Click Install and wait for the installation to complete.
- Once installed, restart Kodi for the plugin to activate.
Verification: After restart, you should see a “TV” option appear in Kodi’s main menu. If you click it and see “No available channels,” the plugin is installed correctly—it just hasn’t been configured yet.
Part 2: Configure Your M3U Playlist
Now you’ll tell the plugin where to find your channel list.
- From Kodi’s main menu, go to Settings (gear icon) → PVR & Live TV → General.
- Find IPTV Simple Client in the list and click Configure.
- In the General tab, locate the M3U Playlist URL or M3U Playlist Path setting.
Choose your M3U source:
| Option | When to Use | How to Set Up |
|---|---|---|
| Local Path | M3U file saved on your device | Click “Browse” and navigate to your .m3u file |
| Remote Path (URL) | M3U hosted online (most common) | Paste the full URL (e.g., https://iptv-org.github.io/iptv/index.m3u) |
💡 Pro Tip: Use a local file path for faster loading and better stability, especially with large playlists. You can store M3U files in Kodi’s userdata folder using the
special://protocol (e.g.,special://home/userdata/playlists/playlist.m3u).
- Enable Auto Refresh – toggle this ON and set the refresh interval to 24 hours. This ensures your channel list stays updated.
- Click OK to save your settings.
Part 3: Configure EPG (Electronic Program Guide) – Optional but Recommended
The EPG gives you a program guide similar to traditional cable TV, showing what’s playing now and what’s coming up.
- In the same Configure screen for IPTV Simple Client, switch to the EPG Settings tab.
- Toggle EPG Enabled to ON.
- In the XMLTV URL or XMLTV Path field, enter your EPG data source URL. (Your IPTV provider usually provides this alongside the M3U URL.)
- Set the EPG Time Offset to match your timezone.
- Set EPG Cache Time to 24 hours.
- Click OK to save.
💡 Advanced Note: The add-on supports both Gzip and XZ compression of XMLTV files, so you can use compressed EPG sources to reduce bandwidth usage.
Free EPG Sources: If your provider doesn’t offer EPG, you can use community-maintained sources like
https://iptv-org.github.io/epg/guides/(varies by country).
Part 4: Enable the Add-on and Load Channels
- Go back to Settings → PVR & Live TV → General.
- Find IPTV Simple Client and click Enable (if it’s not already enabled).
- Restart Kodi completely.
- After restart, navigate to the TV section in Kodi’s main menu.
- Wait 30–60 seconds for the channel list to load (large playlists with 5,000+ channels may take 1–3 minutes).
- You should now see your channels! Select one and start watching.
🎮 Post-Installation UI/UX Walkthrough
Once configured and enabled, here’s what you’ll see when you open the TV section:
| Menu Option | What It Does |
|---|---|
| Channels | Full list of all available channels. Scroll and select any to start watching. |
| Guide (EPG) | Program guide showing what’s currently playing and upcoming schedules (if EPG is configured). |
| Timeline | Visual timeline of programs for the next several hours. |
| Recordings | Access recorded content (if recording is set up and supported). |
| Radio | If your M3U includes radio channels, they appear here. |
Navigation Tips:
- Press OK/Enter on a channel to start streaming.
- Press the Info button while watching to see program details (requires EPG).
- Use the channel up/down buttons on your remote to switch between channels.
- Press the menu button on a channel to add it to Favorites for quick access.
🧰 Troubleshooting: Common Errors & Fixes
❌ “Unable to load M3U list” or channel list is empty
- Check the URL/Path: Verify there are no typos, extra spaces, or special characters in your M3U URL.
- Test the URL elsewhere: Paste the M3U URL into VLC Media Player. If it doesn’t work there, the source is dead.
- Check your internet connection: Ensure your device is connected and can reach the M3U host.
- Local file issues: If using a local file, confirm the file path is correct and Kodi has permission to read it.
- URL redirects: The IPTV Simple Client may have issues with certain URL redirects that work fine in VLC.
❌ Channels appear but won’t play
- Install inputstream.adaptive: Go to
Add-ons→Install from repository→VideoPlayer InputStream→inputstream.adaptiveand install it. - Check stream format: Some streams require specific inputstream plugins (HLS/DASH need
inputstream.adaptive, RTMP needsinputstream.rtmp). - Kodi 22 Piers users: If you see an error about
inputstream.ffmpegdirect, this is a known compatibility issue. Try switching to Kodi 21 “Omega” for stability. - Test with VLC: Copy a channel URL from your M3U and test it in VLC to confirm the stream is active.
- Network issues: Ensure you have at least 10 Mbps bandwidth for smooth streaming.
❌ EPG shows no data or “No information available”
- Verify XMLTV URL: Check that your EPG URL is correct and accessible.
- Check compression: If your XMLTV file is Gzip or XZ compressed, the add-on supports it automatically.
- Check timezone offset: Ensure the EPG Time Offset matches your local timezone.
- Force refresh: In the EPG settings, there’s usually a “Force refresh” or “Clear cache” option.
- Wait: EPG data can take a few minutes to load after initial configuration.
❌ Slow channel loading or buffering
- Check your internet speed: Close other bandwidth-heavy applications.
- Adjust buffer size: In IPTV Simple Client settings →
Advanced→ increase buffer size (default is 1500ms). - Use a wired connection: If possible, connect via Ethernet instead of Wi-Fi.
- Enable hardware decoding: In Kodi settings →
Player→Videos→ enable hardware acceleration. - Large playlists: If your M3U has thousands of channels, use a local file instead of a remote URL for faster parsing.
- Remove unwanted groups: Use a playlist editor to remove unwanted channel groups before loading into Kodi.
❌ “Error 555” when playing certain streams
- Issue: This occurs when Kodi performs an additional check on tokenized one-time-use URLs. This is a known Kodi limitation.
- Workaround: Try using a different stream source within your M3U. Some users report success with
inputstream.adaptivefor these streams. - Alternative: If the stream works in VLC but not in Kodi, the issue is likely with Kodi’s URL handling for that specific stream format.
❌ TV section takes 3+ minutes to load channels
- Large playlists: If your M3U has thousands of channels, loading can be slow.
- Solution: Use a local M3U file instead of a remote URL for faster parsing.
- Alternative: Use a playlist editor to remove unwanted channel groups before loading into Kodi.
- Enable “Only load active channels”: If your provider supports it, this can speed up loading.
❌ Kodi 22 Piers: “Dependency can’t be Satisfied” error
- Issue: This occurs when
inputstream.ffmpegdirectis not available or incompatible with your Kodi 22 build. - Workaround: Use Kodi 21 “Omega” instead, which has stable support for all dependencies.
- For Android users: The Piers branch for ffmpegdirect fails to build on Android due to an SDK change with no current ETA for a fix.
📺 Free M3U Playlist Sources
⚠️ Legal Disclaimer: The following are publicly available M3U lists from open-source projects. These contain legally broadcast free-to-air channels. Always verify the legality of content in your jurisdiction.
| Source | Description | URL |
|---|---|---|
| iptv-org (Global) | 9,000+ international channels, community-maintained | https://iptv-org.github.io/iptv/index.m3u |
| iptv-org (France) | 300+ French channels (TNT + free-to-air) | https://iptv-org.github.io/iptv/countries/fr.m3u |
| iptv-org (Sports) | Sports category channels | https://iptv-org.github.io/iptv/categories/sports.m3u |
| iptv-org (Movies) | Movie category channels | https://iptv-org.github.io/iptv/categories/movies.m3u |
| Free-TV/IPTV | Global free TV channels (FTA) | https://raw.githubusercontent.com/Free-TV/IPTV/master/playlist.m3u8 |
| Free-TV/IPTV (USA) | US-specific channels | https://raw.githubusercontent.com/Free-TV/IPTV/master/lists/usa.m3u8 |
| Kodinerds IPTV | Community-maintained German/European list | https://raw.githubusercontent.com/jnk22/kodinerds-iptv/refs/heads/master/iptv/kodi/kodi_tv.m3u |
🔄 Working Alternatives
If PVR IPTV Simple Client doesn’t meet your needs, consider these alternatives:
| Alternative | Best For | Key Feature | M3U Support | Xtream Codes |
|---|---|---|---|---|
| XCIPTV Player | Advanced IPTV users | PVR integration, multi-profile | ✅ Yes | ✅ Yes |
| pvr.satip | SAT>IP users | Auto-discovers servers on network | ✅ Yes | ❌ No |
| Dispatcharr | Self-hosters | M3U/EPG/HDHomeRun proxy | ✅ Yes | ✅ Yes |
| TiviMate | Android TV users | Premium IPTV player | ✅ Yes | ✅ Yes |
For more IPTV options, check our guides on best IPTV player apps and best IPTV players for Windows.
🔒 Safety, Legal & E-E-A-T Disclaimers
Legal Considerations
- PVR IPTV Simple Client is a tool, not a content provider. It does not host, store, or distribute any copyrighted material.
- M3U playlists are simply text files containing channel names and stream URLs. The legality depends entirely on the source of those streams.
- Free-to-air channels (like those from iptv-org) are legally broadcast and publicly available.
- Paid IPTV services vary in legality. Always verify your provider is properly licensed.
- User responsibility: You are solely responsible for ensuring you only access content legally available in your jurisdiction.
Privacy & Security
- Your IP address is exposed when streaming IPTV content. Your Internet Service Provider can see your streaming activity.
- Strongly recommended: Use a VPN to:
- Hide your IP address and streaming activity from your ISP
- Prevent bandwidth throttling (ISP’s intentionally slowing your connection)
- Bypass geo-restrictions on certain channels
- Malware risk: Only download M3U files from trusted sources. Free playlists from unknown sources may contain malicious links or trackers.
- Official source only: Always install PVR IPTV Simple Client from Kodi’s official repository – never from third-party zip files.
Transparency & Testing
This guide was written after hands-on testing of PVR IPTV Simple Client on multiple devices including:
- Amazon Fire TV Stick 4K Max (Fire OS 8)
- Chromecast with Google TV
- NVIDIA Shield TV
- Windows 11 PC with Kodi 21 (Omega) and Kodi 22 (Piers)
All configuration steps were verified to work as of August 10, 2026.
⚠️ Disclaimer: This guide is for educational and informational purposes only. Simturax does not condone copyright infringement. Users should only access content they have the legal right to view.
❓ Frequently Asked Questions (FAQ)
Do I need to enable “Unknown Sources” to install PVR IPTV Simple Client?
No. This is an official Kodi add-on from the built-in repository. You do not need to enable “Unknown Sources” – unlike third-party add-ons like The Crew or Umbrella.
What’s the difference between M3U and Xtream Codes?
M3U is a simple text file containing channel names and stream URLs. Xtream Codes is an API-based system (server URL + username + password) that provides dynamic playlist access with additional features like VOD and series support. PVR IPTV Simple Client supports M3U only – for Xtream Codes, use alternatives like XStream Player.
Why can’t I see the “TV” section in Kodi after installing?
The “TV” section only appears after you’ve configured the plugin AND enabled it. Go to Settings → PVR & Live TV → General, find IPTV Simple Client, and click Enable. Then restart Kodi.
Can I use multiple IPTV providers with this plugin?
Yes – Kodi 20 (Nexus) and above support multi-instance configuration. Go to Settings → PVR & Live TV → Manage PVR Clients → IPTV Simple Client → Add Instance. Each instance can have its own M3U and EPG.
Does PVR IPTV Simple Client support 4K streaming?
Yes – if your M3U source provides 4K streams. The plugin itself doesn’t limit resolution; it passes whatever stream the M3U URL points to.
Why is my channel list taking so long to load?
Large M3U playlists (5,000+ channels) can take 1–3 minutes to load. To speed this up:
- Use a local file instead of a remote URL.
- Use a playlist editor to remove unwanted groups before loading.
- Enable “Only load active channels” if your provider supports it.
Is PVR IPTV Simple Client free?
Yes – it’s completely free and open-source (GPL-2.0-or-later license). However, you may need to pay for a subscription to your IPTV provider for their M3U playlist.
Can I record live TV with this plugin?
PVR IPTV Simple Client supports basic recording if your IPTV provider allows it. For advanced recording features, you may need additional configuration or alternative PVR backends.
Does the add-on work on Kodi 22 “Piers”?
⚠️ Yes, but with caveats. The add-on has dedicated builds for Kodi 22 (version 22.6.4), but there are known compatibility issues with inputstream.ffmpegdirect on Windows and Android. If you encounter errors, Kodi 21 “Omega” is recommended for stability.
Does the add-on support compressed XMLTV files?
Yes – the add-on supports both Gzip and XZ compression of XMLTV files. This can significantly reduce bandwidth usage for EPG data.
💎 Conclusion
Adding an IPTV M3U file to Kodi using the PVR IPTV Simple Client is one of the simplest and most reliable ways to watch live TV on Kodi. Since it’s an official add-on from Kodi’s built-in repository, you don’t need to worry about enabling “Unknown Sources” or dealing with sketchy third-party zip files.
Quick Recap:
- ✅ Install PVR IPTV Simple Client from Kodi’s official repository (Add-ons → Install from repository → PVR clients)
- ✅ Configure your M3U playlist URL (local or remote) in the plugin settings
- ✅ Optional: Set up XMLTV EPG for a full program guide (Gzip/XZ compression supported)
- ✅ Enable the plugin and restart Kodi
- ✅ Navigate to the TV section and start watching
Final Recommendations:
- 🔒 Use a VPN to protect your privacy and prevent ISP throttling
- 📋 Use local M3U files when possible for faster loading
- 🔄 Set auto-refresh to 24 hours to keep channel lists current
- 🎯 Start with a free playlist (like iptv-org) to test before committing to a paid provider
- ⚠️ Kodi 22 users: Be aware of
inputstream.ffmpegdirectcompatibility issues – Kodi 21 “Omega” is recommended for stability
This guide was written by Simturax – a technology and streaming media specialist with over 10 years of experience covering Kodi, Firestick, Android TV, and IPTV. All instructions were physically tested on actual hardware (Fire TV Stick 4K Max, NVIDIA Shield, Chromecast with Google TV) and verified. We prioritize accuracy, transparency, and user safety above all else.
