High-performance XC / XCUI playback for Kodi — Live TV · VOD · Catch-up · TV Series
Optimized for Kodi v21 (Omega) & Python 3
Official Kodi repository: Nigel1992/kodi-repository
XCUI Streams is a fast, reliable XC/XCUI playback add-on for Kodi 21 (Omega). It provides modern parsing, persistent caching, clean navigation, and a built-in TV guide, optimized for inconsistent provider APIs.
Quick links: Latest release · Installation · Features · Troubleshooting · Issues
- Fast Live / VOD / Series / Catch-up navigation with persistent file-based caching
- Live TV [Filtered] menu to filter categories by text
- Configurable cache expiry per content type (Settings → Cache)
- TV Series with seasons and episodes
- Catch-up TV (provider-dependent)
- Speed test and advanced settings presets
- Icon-host reachability checks (dead icon servers never stall the UI)
- Custom EPG / TV Guide — in-addon EPG window with two-panel layout, category browsing, search, progress bars, and info panel
- EPG remembers last category and plays the channel when a programme is selected
- Live programme info in the player overlay (press Info during playback)
- Fast playback startup via Kodi's standard resolver, automatic fullscreen
- Favorites — long-press to add/remove; dedicated Favorites menu on home
- Recently Watched History — logs the last 25 streams (configurable); clearable from Extras
- Multi-Server Profiles — save, switch, and delete provider credentials (cache auto-cleared on switch)
- Last Played quick-resume item at the top of home
- Live pause/timeshift on supported
.tsstreams - Auto-reconnect for live streams with progressive backoff
- Watched indicators in episode lists
- Trakt scrobbling via the separate
script.traktaddon
| Component | Requirement |
|---|---|
| Kodi | v21 (Omega) or newer |
| Python | Python 3 (bundled with Kodi) |
| Account | Active XC / XCUI-compatible provider (host, username, password) |
- Download the latest release: Releases
- Or install from the official repository: Nigel1992/kodi-repository
- In Kodi:
Settings→Add-ons→Install from zip file→ selectplugin.video.iptvxc-<version>.zip - Open the add-on and enter provider credentials in Settings → General
- Open XCUI Streams from Video add-ons
- Browse: Live TV, VOD, TV Series, Catch-up TV
- Series flow: Series → Season → Episode → Play
- Navigation map:
- Live TV → Categories → Channels → Play
- VOD → Categories → Titles → Play
- Series → Show → Season → Episode → Play
- Catch-up → Channel → Program → Play (if supported)
Pause live TV (timeshift)
- Works on supported
.tslive streams. - Enable it in
Settings→Playback→ Live TV Pause / Timeshift (.ts). - While watching, use Kodi's pause button. The stream keeps a buffer on disk so you can rewind/pause.
- Pause length depends on disk space (up to ~9 hours).
Auto-reconnect for live streams
- If a live stream stops or errors, the addon retries automatically.
- Toggle and max retries are in
Settings→Playback. - Uses progressive backoff (3s, 5s, 8s, 10s, 15s).
- Rapid crashes count faster toward the limit.
Live TV [Filtered]
- Open Live TV [Filtered] from the home menu.
- Set the filter text in
Settings→General→ Live TV category filter. - Only categories containing that text (case-insensitive) are shown.
Watched indicators
- Played episodes get a native Kodi watched checkmark in lists.
- No setup needed; just play an episode.
Favorites & history
- Long-press any item to add/remove from Favorites.
- Favorites menu groups Live TV, Movies/VOD, and Series.
- Recently Watched logs the last 25 streams (configurable) and is clearable from Extras.
Multi-server profiles
- Save, switch, and delete provider credentials from Settings → Switch Server.
- Cache is auto-cleared on switch.
EPG / TV Guide
- Built-in EPG window with category browsing, search, and progress bars.
- Selecting a programme plays that channel.
Trakt scrobbling (via script.trakt)
- Install script.trakt from the Kodi repository and authorize it with your Trakt account.
- In script.trakt settings, disable Exclude Plugin, Exclude HTTP, and Exclude Script so this addon's streams are not skipped.
- In this addon:
Settings→Trakt→ enable Enable Trakt (via script.trakt addon). - Play a movie or episode; script.trakt will scrobble automatically using the metadata provided by this addon.
Cache & performance
- Persistent file-based caching for Live TV, Movies/VOD, Series, and Catch-up.
- Configurable cache expiry in
Settings→Cache. - Clear cache from Extras → Clear Cache.
After an update
- The addon clears old cache/bytecode automatically.
- A "what's new" dialog is shown once.
- If anything looks odd, restart Kodi.
XCUI Streams can send anonymous usage pings to help gauge adoption. Enabled by default (opt-out).
- Pings: one per install (total installs) and one per day per install (daily active).
- No credentials, personal data, or device identifiers are sent.
- A random anonymous ID is generated and stored locally; it is never transmitted.
- Toggle: Settings → Features → Send anonymous usage ping (opt-out)
- Counter endpoints are configurable in Settings → Features.
- Disable the setting to stop pinging.
- No content visible? Verify provider credentials and 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; open an issue with your host if something breaks.
Total installs and daily active counts are tracked via an anonymous opt-out ping (enabled by default). Raw counters: installs · daily
See the full changelog: CHANGELOG.md
- Report bugs: use the
buglabel with reproduction steps. - Request features: use the
enhancementlabel. - Contribute code: submit a PR referencing the related issue.
Issues and PRs are welcome. Please avoid sharing provider credentials publicly. Include Kodi version, platform, and logs when reporting bugs.
- Original work by Fire TV Guru
- Community contributions and testing
All donations go to your chosen charity. Your name will be listed as a supporter/donor. Contact: thedjskywalker@gmail.com