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.
 

[Apotropaic 41]

I'm just testing out some of the functionality and so far it's been very positive, a great project so well done!

One query I have is, what if there is a scenario where you don't want to enter the upstream credentials and only want to use dispatcharr? I've entered my dispatcharr account in the initial Connection Settings but I have not enabled the dispatcharr integration.

Does the plug-in know I am using a dispatcharr server so I get those benefits, or am I not using this as designed?

Just for info, if I do enable the dispatcharr integration and I enter the same credentials the connection test fails with "✗ Login failed (HTTP 401). Response: {"detail":"No active account found with the given credentials"}"

[lorac 118]

On 01/03/2026 at 05:36, Firestaerter said:

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.
 

Thanks for the info on cleaning. Seems to have helped a lot.

Using v1.4.26.0 with emby stable 4.9.3.0

What I've discovered is the information is saved but it is not always reflected right away. If I navigate to the emby dashboard and then back to the plugin page everything looks normal.

I tested on a different server with 1.4.39 and I don't see that issue.