[!IMPORTANT]
High-performance XC / XCUI playback for Kodi Live TV โข VOD โข Catch-up โข TV Series
Optimized for Kodi v21 (Omega) & Python 3.13
Official Kodi Repository for this addon: ๐ Nigel1992/kodi-repository
Quick links: Latest release ยท Installation ยท Troubleshooting ยท Issues
Built for fast, reliable XC/XCUI playback on Kodi 21 (Omega) with modern parsing, caching, and clean navigation.
- โก Performance-first browsing for Live, VOD, Series, Catch-up
- ๐ฐ๏ธ Resilient XML/JSON parsing tuned for XC/XCUI panels
- ๐งญ Simple router-style navigation with restored series flows
- ๐ ๏ธ Built-in speed test and advanced settings presets
- ๐ง Defensive handling of inconsistent provider payloads
- ๐ฏ Optimized for Kodi v21 (Omega) / Python 3.13
A huge thank you to the supporters who have contributed to charity through this project:
| Donator | Date | Goal / Charity |
|---|---|---|
| Joe/Joseph T | March 2026 | KWF |
| Your Name? | 2026 | Your Choice |
- Fast Live/VOD navigation with persistent file-based caching
- Configurable cache expiry per content type (Live TV, Movies, Series) in Settings โ Cache
- TV Series with seasons/episodes restored
- Catch-up TV (provider-dependent)
- Speed test and advanced settings helpers
- Robust handling of inconsistent provider APIs
- Icon-host reachability checks โ dead icon servers never stall the UI
- Custom EPG / TV Guide โ full in-addon EPG window with two-panel layout (channels + programme schedule), category browsing, search for categories and channels, progress bars on currently airing shows, and info panel
- EPG remembers last category โ reopening the TV Guide auto-loads the previously viewed category
- Programme click plays channel โ selecting any programme in the schedule plays that channel directly
- Live programme info in player overlay โ pressing Info (i) during playback shows the current programme title, description, and channel name
- Auto-updating EPG info โ background thread refreshes programme metadata every 60 seconds during playback so the info overlay always shows the current show
- Favorites โ long-press any channel, movie, or series to add/remove from Favorites; new Favorites menu on home screen for instant access to your most-watched content
- Recently Watched History โ automatically logs the last 25 streams played (configurable); accessible from the home screen with timestamps; clear from Extras
- Multi-Server Profiles โ save, switch between, and delete multiple IPTV server credentials from Settings โ Switch Server; cache is auto-cleared on switch
- Last Played โ the last played stream appears at the top of home as a quick-resume item
- Install from the latest zip: https://github.com/Nigel1992/plugin.video.iptvxc/releases/latest
- Open Kodi โ Add-ons โ Install from zip โ select
plugin.video.iptvxc-<version>.zip - Enter provider credentials in Settings โ Accounts
- Browse Live / VOD / Series / Catch-up
- Kodi 21 (Omega) or newer
- XC/XCUI-compatible account (host, username, password)
- Network access to your providerโs panel
- Live TV โ Categories โ Channels โ Play
- VOD โ Categories โ Titles โ Play
- Series โ Show โ Season โ Episode โ Play
- Catch-up โ Channel โ Program โ Play (if provider supports)
- Tools โ Speed Test / Advanced settings presets
| Component | Requirement |
|---|---|
| Kodi | v21 (Omega) or newer |
| Python | 3.13 (bundled with Kodi v21) |
| Account | Active XC / XCUI-compatible provider |
-
Download the latest release ๐ https://github.com/Nigel1992/plugin.video.iptvxc/releases
-
Or install from the official Kodi repository ๐ Nigel1992/kodi-repository
-
Install in Kodi
SettingsโAdd-onsโInstall from zip file- Select
plugin.video.iptvxc-<version>.zip
-
Configure
- Open the add-on
- Enter your provider credentials in Settings
- Open XCUI Streams from Video add-ons
- Browse: Live TV, VOD, TV Series, Catch-up TV
- TV Series flow: Series โ Season โ Episode
- Search: added scoped search popup for Live TV & Catchup / Movies/VOD / Series / All sections.
- Network: added
net_timeout,net_retries,net_backoffsettings with explanation in Settings > Network. - Stability: added retry/backoff and fallback to cache for panel/vod/series endpoints on transient failures.
- Logic: added deterministic dedupe+sort and state persistence for query + scope (restore on back navigation).
- Favorites: top-level Favorites now show category entries only (Live TV / Movies/VOD / Series) with counts โ click a category to view that category's favorited items.
- Favorites: added automatic classification and a stored
categoryfor favorites (live / vod / series) so items are grouped correctly when listed. - Playback: added per-category subtitle toggles in Settings โ Playback (
subtitles_live,subtitles_vod,subtitles_series) and enforced subtitle visibility per-category at playback start. - Bug fixes: small playback and EPG fixes (including a typo fix in the EPG updater call) and a number of defensive checks.
- Mapped menu
icon_*.pngfiles inresources/media/to home menu items. - Added
icon_LAST_PLAYED.pngand set it as the Last Played home icon. - Set Extras to use
icon_EXTRAS.pngas a local fallback. - Fixed
IndentationErrorindefault.py(normalized ART PATHS). - Packaged and published release
v3.8.4with a clean ZIP.
- Fixed freeze/slowdown when pressing X to stop a stream.
- Fixed Kodi becoming unresponsive on Stop or stuck busy dialogs.
- Added persistent file-based caching with user-configurable expiry.
- Custom EPG / TV Guide โ full self-contained in-addon EPG window.
- Favorites & Recently Watched โ history logging and home screen access.
- Multi-Server Profiles โ save and switch between multiple provider credentials.
- Playback now automatically retries up to 5 times if the connection drops.
- No content visible? Verify provider credentials and check network connectivity.
- Missing metadata: Normal for some providers.
- Deprecation warnings:
ListItem.setInfo()warnings do not affect playback. - Provider differences: Not all providers share the same API structure; open an issue with your host name if something breaks.
Issues and PRs are welcome. Please avoid sharing provider credentials publicly. Include Kodi version, platform, and logs when reporting bugs.
We use GitHub Projects to track issues and the roadmap: View the board here
- Report bugs: Use the
buglabel with reproduction steps. - Request features: Use the
enhancementlabel. - Contribute code: Submit a PR referencing the related issue.
- Original work by Fire TV Guru
- Community contributions and testing
Support this project! All donations go towards your chosen charity. You can pick any charity you'd like, and I will ensure the funds are sent their way. Please note that standard payment processing fees (Ko-fi & PayPal) will be deducted from the total. As a thank you, your name will be listed as a supporter/donor in this project. Feel free to email me at thedjskywalker@gmail.com for proof of the donation or to let me know which charity you've selected!
