Threadfin on a Seedbox: M3U IPTV Proxy for Plex DVR

What Threadfin Is

Threadfin sits between an M3U IPTV source and your media server. It pretends to be an HDHomeRun network tuner, which is the format Plex DVR, Jellyfin, and Emby's live TV features speak natively. Behind the scenes, it's pulling streams from an M3U list.

The result: you can use Plex DVR or Jellyfin's live TV with an IPTV subscription, even though IPTV providers don't ship HDHomeRun-compatible feeds.

It's the modern fork of xTeVe, with active development and bug fixes the original stopped getting.

Why Run It on a Seedbox?

Threadfin needs to be reachable from Plex or Jellyfin and stay running. A seedbox covers it:

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

Open the Bytesized Panel, find Threadfin in the app catalog, click install. The panel sets up the container, the reverse proxy, and gives you a clean HTTPS URL.

Click "Open" to land on the dashboard.

First-Run Setup

1. Add an M3U source. Settings > M3U > Add. Plug in the URL of your IPTV provider's M3U feed. Threadfin reads the channel list.
2. Add an EPG (XMLTV). Most IPTV providers also provide an EPG URL. Settings > XMLTV > Add. This populates the program guide.
3. Map channels. Threadfin's mapping tab lets you align M3U channel names to EPG entries. Some manual cleanup is normal here; the matcher gets most channels right but a few always need touching.
4. Configure Plex DVR / Jellyfin. Add Threadfin as an HDHomeRun tuner using its internal URL.

Pairing With Plex DVR

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

• Use Threadfin's internal URL from the panel
• Plex detects it as an HDHomeRun and pulls the channel list
• Pick the channels you want, set the EPG source, you're done

Plex now has live TV. You can record into your library with the same folder layout it uses for normal TV.

Pairing With Jellyfin

Jellyfin's Live TV setup is similar:

• Add an HDHomeRun tuner
• Use Threadfin's internal URL
• Jellyfin pulls the channels and EPG
• Set a recording folder, and DVR features light up

Jellyfin's live TV experience isn't quite as smooth as Plex's, but it works.

Channel Filtering

A typical M3U from an IPTV provider has thousands of channels. Most you'll never watch. Threadfin's filter tab lets you whitelist groups (e.g., only "USA Sports" and "USA News") so Plex only sees what you care about.

Plex DVR also has its own per-channel hide settings; do the heavy filtering in Threadfin first to keep Plex's setup lighter.

Common Gotchas

EPG not showing in Plex. Most often an XMLTV mismatch. Threadfin's EPG matching is lenient but not magic. Manually map the offending channels.

Streams won't play. Test in VLC first using the underlying M3U URL. If VLC can't play it, the source is the problem; if VLC can but Plex can't, it's a Plex transcoding issue.

Tuner count too low. Each concurrent stream needs a tuner slot. Threadfin's settings let you increase the virtual tuner count; some providers cap concurrent streams on their end too.

Provider blocked the seedbox IP. Some IPTV providers geo-restrict or rate-limit. The provider has to whitelist the seedbox IP, or you'll need a different provider.

Threadfin vs xTeVe

xTeVe was the original; Threadfin forked from it when xTeVe development stalled. For new installs, Threadfin. xTeVe is here for people running it long-term who don't want to migrate.

See the xTeVe guide for the older alternative.

FAQ

Is Threadfin free? Yes. Free and open source.

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

Does it work with Channels DVR? Channels DVR supports M3U sources directly, so you don't need Threadfin in the chain. Threadfin is for Plex DVR, Jellyfin, and Emby specifically.

Can multiple media servers share Threadfin? Yes. Threadfin is just a proxy; Plex and Jellyfin can both pull from it simultaneously, subject to your IPTV provider's concurrent stream limits.

Will it transcode? No. Threadfin proxies the stream as-is. Transcoding is your media server's job.

Ready to Set It Up?

Browse Appbox plans, install Threadfin from the panel, point it at your IPTV M3U, and set up Plex DVR or Jellyfin live TV against it.