Xtream Tuner — turn your IPTV subscription into a full Emby Live TV

[Firestaerter 4]

I've been building a plugin that connects any Xtream-compatible IPTV subscription directly to Emby as a first-class citizen — Live TV with a proper guide, *and* your VOD content as a native movie and series library. Just one DLL, no extra dependencies.

What you get

•   - IPTV movies as a real Emby library — synced as STRM files with full metadata, posters, and ratings matched via TMDB. Emby treats them exactly like local files.
•   - IPTV series with proper episode structure — seasons and episodes organised as Show Name / Season 01 / S01E01, matched against TVDb and TMDB for automatic metadata.
•   - Flexible folder organisation — one flat library, per-category folders, or a fully custom mapping for both movies and series.
•   - Category filtering and name cleaning — pick exactly which content to include, and strip provider tags like |UK| or |FR| from titles automatically.
   

Extra for Dispatcharr users (https://github.com/Dispatcharr/Dispatcharr)

• Fast channel switching — the plugin reads stream stats pre-populated by Streamflow and passes codec and resolution info directly to Emby, suppressing the stream probe entirely. Channels open immediately with no black-screen delay.

• Graceful fallback — if Dispatcharr is unreachable, the plugin automatically falls back to direct Xtream URLs so playback keeps working.
   

Setup

Drop the DLL into your plugins folder, restart Emby, enter your Xtream server URL and credentials, pick your channel categories, and you're done. The plugin handles the rest — initial sync, incremental updates, duplicate detection across categories, and cleanup of removed content.

Updates

The plugin checks for new releases automatically and shows a banner when one is available. There's a beta channel in the config if you want updates earlier.

Releases and docs: https://github.com/firestaerter3/emby-xtream

Happy to answer questions — and if something doesn't work with your provider, bug reports are very welcome.

Edited Friday at 01:51 PM by Firestaerter
update

[drahmed86 4]

am rlly enjoying using it but dunno how to use streamflow ? is it necessary for all or just live tv ? TIA

[lorac 118]

• I find that the folder names are not clean (ie. 4K-A+ - before the show name) despite the clean option being enabled.
• If I change the server URL various check boxes become unchecked, if i check them again it gives me an error of 'failed to save configuration'. The dashboard also says 'Xtream: Not configured' despite the fact I was able to sync after I changed the server URL

[kikinjo 288]

great plugin !

[Firestaerter 4]

On 2/27/2026 at 7:58 PM, drahmed86 said:

am rlly enjoying using it but dunno how to use streamflow ? is it necessary for all or just live tv ? TIA

Only for Live TV: will accelerate channel switching, by having 'pre-probed' the video meta data of all channels.

[Firestaerter 4]

19 hours ago, lorac said:

• I find that the folder names are not clean (ie. 4K-A+ - before the show name) despite the clean option being enabled.
• If I change the server URL various check boxes become unchecked, if i check them again it gives me an error of 'failed to save configuration'. The dashboard also says 'Xtream: Not configured' despite the fact I was able to sync after I changed the server URL

Thanks for the report — two separate things going on here.

Folder name prefix not being cleaned (4K-A+)

The clean option is working, but it only strips `┃UK┃` / `|EN|` style pipe-bracket tags automatically. Plain dash-separated quality prefixes like `4K-A+ - Show Name` aren't covered by the automatic patterns yet.

Workaround Go to Plugin Config → Settings → Name Cleaning, make sure cleaning is enabled, and add the prefix to the Remove Terms box (one per line):

```
4K-A+ -
```

That will strip it from folder and file names on the next sync. Better automatic pattern matching for quality prefixes is on the list.

---

Failed to save configuration" after changing the server URL

A few questions to help track this down:

1. What Emby server version are you on and what version of plugin?
2. Can you open the browser console (F12 → Console tab) and share any errors that appear at the moment you hit Save?
3. Does the checkbox issue happen immediately when you type the new URL, or only after you save and the page reloads?

On the "Xtream: Not configured" message — if sync was working after the URL change, the config 'is' saved correctly. That indicator just checks whether the URL and username fields are non-empty, so it may just need a full page reload to update.