xTeVe on a Seedbox: M3U Proxy for Plex DVR (Legacy)

What xTeVe Is

xTeVe presents an M3U IPTV source as a virtual HDHomeRun network tuner, so Plex DVR, Jellyfin, and Emby can read live TV from an IPTV provider that doesn't natively speak the HDHomeRun protocol.

Heads Up: Use Threadfin Instead

xTeVe development has been quiet for some time. The actively-maintained fork is Threadfin, which fixes bugs and tracks Plex DVR API changes that broke the original.

For new setups, install Threadfin. xTeVe is here for users who set up their stack on it years ago and don't want to migrate.

The rest of this guide covers xTeVe specifically.

Why Run It on a Seedbox?

Same as Threadfin:

• One-click install
• Same panel as Plex / Jellyfin / Emby
• 24/7 uptime so the EPG stays current
• 10 Gbit, so transcoding-heavy streams don't bottleneck
• EU servers in Luxembourg, France, and Netherlands

Installing xTeVe

Open the Bytesized Panel, find xTeVe in the app catalog, click install. The panel sets up the binary, the reverse proxy, the URL.

Click "Open" to land on the dashboard.

First-Run Setup

1. Add an M3U source. Settings > Files > M3U.
2. Add an EPG. Settings > Files > XMLTV.
3. Map channels. Mapping tab. Match M3U entries to EPG entries.
4. Configure Plex DVR / Jellyfin. Add xTeVe as an HDHomeRun tuner.

Same shape as Threadfin's setup. The UI is older.

Plex DVR Setup

In Plex > Settings > Live TV & DVR > Set Up Plex DVR > "Have an HDHomeRun?":

• Use xTeVe's internal URL from the panel
• Plex picks up the channel list
• Set the EPG source

Plex now has live TV through your IPTV provider.

Common Gotchas

Plex says no HDHomeRun found. Use the internal URL from the panel for the HDHomeRun address, not the public HTTPS one.

EPG missing. xTeVe's mapping is fussier than Threadfin's. Manually map channels that aren't auto-matching.

Stream errors. Update the M3U; provider URLs change. Settings > Files > Update.

Newer Plex versions reject xTeVe. Plex DVR's API has evolved; older xTeVe builds occasionally trip on it. If you're hitting persistent issues, this is when migrating to Threadfin makes sense.

Migrating to Threadfin

If you decide to move:

1. Note your M3U URL, EPG URL, and your channel mapping.
2. Install Threadfin from the panel.
3. Re-add the same sources in Threadfin.
4. Reconnect Plex DVR / Jellyfin to Threadfin's URL.
5. Retire xTeVe.

The Threadfin UI is similar enough that the move is straightforward.

FAQ

Is xTeVe free? Yes. Free and open source.

Should I use xTeVe or Threadfin? Threadfin for new installs. xTeVe if you're already on it and not seeing problems.

Will it work with Plex DVR? Yes, with the caveat that Plex's API changes occasionally break older xTeVe builds.

Do I need an IPTV subscription? Yes. xTeVe doesn't provide content; it presents your M3U source.

Can I run both xTeVe and Threadfin? Yes. Different ports. You'd usually only do this temporarily during a migration.

Ready to Set It Up?

Browse Appbox plans, install xTeVe from the panel, add your M3U and EPG. For new setups, install Threadfin instead.