Skip to content

About

Kodi IPTV add-on for XC/XCUI providers: Live TV, VOD, Series, Catchup. | Join our Discord: https://discord.gg/9F2NZuydXT

Topics

Resources

Stars

14 stars

Watchers

1 watching

Forks

Repository files navigation

XCUI Streams

plugin.video.iptvxc

High-performance XC / XCUI playback for Kodi — Live TV · VOD · Catch-up · TV Series

Optimized for Kodi v21 (Omega) & Python 3

Latest Release Version Kodi Python Issues Discord Vibe Coded

ko-fi

Official Kodi repository: Nigel1992/kodi-repository


🚀 Overview

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


✨ Features

  • 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 .ts streams
  • Auto-reconnect for live streams with progressive backoff
  • Watched indicators in episode lists
  • Trakt scrobbling via the separate script.trakt addon

📋 Requirements

Component Requirement
Kodi v21 (Omega) or newer
Python Python 3 (bundled with Kodi)
Account Active XC / XCUI-compatible provider (host, username, password)

📦 Installation

  1. Download the latest release: Releases
  2. Or install from the official repository: Nigel1992/kodi-repository
  3. In Kodi: Settings → Add-ons → Install from zip file → select plugin.video.iptvxc-<version>.zip
  4. Open the add-on and enter provider credentials in Settings → General

▶️ Usage

  • 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)

🧩 Features & how to use

Pause live TV (timeshift)
  • Works on supported .ts live 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)
  1. Install script.trakt from the Kodi repository and authorize it with your Trakt account.
  2. In script.trakt settings, disable Exclude Plugin, Exclude HTTP, and Exclude Script so this addon's streams are not skipped.
  3. In this addon: Settings → Trakt → enable Enable Trakt (via script.trakt addon).
  4. 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.

🔒 Privacy & opt-out

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.

🛠️ Troubleshooting

  • 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.

📊 Usage statistics

Total Downloads (all releases) Telemetry Installs Today's Installs Today's Active Daily Active (Cumulative)

Total installs and daily active counts are tracked via an anonymous opt-out ping (enabled by default). Raw counters: installs · daily


📝 Release History

See the full changelog: CHANGELOG.md


🤝 Contributing

  • Report bugs: use the bug label with reproduction steps.
  • Request features: use the enhancement label.
  • 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.


🙏 Credits

  • Original work by Fire TV Guru
  • Community contributions and testing

Support This Project

All donations go to your chosen charity. Your name will be listed as a supporter/donor. Contact: thedjskywalker@gmail.com

ko-fi

About

Kodi IPTV add-on for XC/XCUI providers: Live TV, VOD, Series, Catchup. | Join our Discord: https://discord.gg/9F2NZuydXT

Topics

Resources

Stars

14 stars

Watchers

1 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages