IPTV-Proxy 1.1 connects legal Xtream Codes subscriptions to Emby
A third-party project posted on the Emby community forum, IPTV-Proxy, is out in version 1.1 (as of 30 October 2026). It is aimed at Emby users who hold an IPTV subscription delivered through Xtream Codes and want that subscription to behave like a native part of their media center.
The tool runs as a Docker container alongside Emby and is configured in the browser. From there it keeps channels, the programme guide and the media library synchronized on its own, so you are not rebuilding playlists by hand every time something changes.
What it does
- Live TV: generates an M3U playlist and XMLTV EPG, and can present itself as an HDHomeRun tuner so Emby handles recording itself. You can pick countries (Germany, optionally Austria and Switzerland), set exclusion rules and custom groups, order main channels, assign channel numbers and short names, and merge HD/4K/SD variants of the same channel into one entry with the others kept as backups. Channels that vanish briefly stay for six hours so timers and favorites survive.
- Playback stability: switches to the next variant within seconds when there is no picture, reconnects dropped streams, buffers short dropouts, and gives Live TV priority when only one connection is allowed. Satellite via SAT>IP or DVBViewer Media Server is also supported as a source. A nightly check plays each variant briefly and moves dead ones to the back.
- EPG: combines provider data with extra XMLTV sources and add-ins matched by channel name, fills gaps, adds placeholder blocks and pulls logos from tv-logos.
- Library sync: selected provider categories become separate Emby libraries, synced nightly, with Emby fetching artwork and descriptions itself. It skips documentaries, detects duplicates and cam rips, corrects bad matches and adds a "Missed" library from the provider archive covering the last five days.
- Local library on the NAS: downloads films and episodes overnight in the best version with German audio, fills missing episodes, re-encodes large files to HEVC on Intel graphics after an SSIM quality check, and verifies each downloaded file by playing it once, re-downloading faulty ones.
Who it affects
Emby users who already pay for an IPTV subscription and run Docker will get the most from this. It is not a source of content by itself: it assumes a legitimate Xtream Codes subscription you are entitled to use.
Commentary for self-hosters
Treat this as glue, not as a content source. Before deploying, confirm your subscription terms allow this kind of client-side aggregation and the number of simultaneous connections you are paying for, since the priority logic exists precisely because connections are limited. The nightly channel check and file verification are the features worth having: they turn silent failures into something you can see. Run it on the same Docker network as Emby, keep the container updated, and test the HDHomeRun path first if you want Emby to own your recordings. If you would rather extend Emby with our own add-ons, have a look at our Emby plugins.