Threadfin

Threadfin is an M3U proxy that feeds filtered IPTV channel lists to Plex DVR, Emby, and Jellyfin live TV, based on the xTeVe project.

  • Media Applications
  • Media Servers
  • Other
  • Tools & Utilities
Threadfin is an M3U proxy that feeds filtered IPTV channel lists to Plex DVR, Emby, and Jellyfin live TV, based on the xTeVe project. It filters and organizes channels, buffers streams in RAM, and keeps TV metadata flowing from your IPTV source to your media server.

Platform availability

Available on 3 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS
  • Proxmox
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

57/100 Fair

Maintained
31last commit 418 days ago
Popular
651,755 GitHub stars
Easy to install
553 install platforms, install notes, Docker image
Light to run
No data
Security check
100no serious findings, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 7 days ago

GitHub stars
1,755
Open issues
8
Last commit
2025-09-29
Latest release
1.2.37
License
MIT
Activity
stale

Checked 20 days ago - source: GitHub (Threadfin/Threadfin)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Use Docker Compose with port 34400 Use the Docker Compose example and keep port 34400 open, because it is Threadfin's main web and live-TV port. Set PUID/PGID (the user and group IDs the container runs as) to match your folders, or Threadfin may fail to save settings and your media server may not be able to reach it. source
  • Save the config folder Mount ./data/conf inside the container so your channel lineup and guide settings are kept on your host. If that folder is deleted or not saved, Threadfin will lose everything you configured. source
  • Add Threadfin to Emby or Jellyfin In Emby or Jellyfin, add Threadfin as an HDHomeRun tuner at http://YOUR_THREADFIN_IP:34400 and set the XMLTV guide to http://YOUR_THREADFIN_IP:34400/xmltv/threadfin.xml. Replace YOUR_THREADFIN_IP with Threadfin's IP address, or your media server will not find live TV channels or the program guide. source
  • Requirements Plex DVR requires Plex Media Server 1.11.1.4730+ and a Plex Pass; Emby requires server 3.5.3.0+ with Emby Premiere; Jellyfin requires server 10.7.1+ with live-TV client support. source

Fetched 43 days ago - each note links to its source

Alternatives (1)

  • Dispatcharr - Dispatcharr is an Internet Protocol television (IPTV) streaming playlist editor and proxy for M3U and M3U8 sources.

Checked 51 days ago - source: AlternativeTo

Common questions

Which port should I expose for Threadfin, and what endpoints do I use in Emby or Jellyfin?

Expose port 34400 and add Threadfin as an HDHomeRun tuner at the Threadfin IP on port 34400. Use the XMLTV guide at /xmltv/threadfin.xml on the same host.

Why do some people enable FFmpeg in Threadfin?

Some users enable FFmpeg to avoid audio/video sync problems and streams that are not properly formatted when using direct passthrough.

Why does Threadfin hang while I filter a large channel list?

A very large channel list can make the Threadfin Docker container hang during filtering.

Can Threadfin serve multiple Plex instances?

Yes, it can be used as an IPTV proxy for multiple Plex instances, with one active instance pulling the feed and using RAM disk transcoding.

Why might Threadfin show a red status after a Plex DVR stream stops?

After a first live stream works, Threadfin can show a red status indefinitely and report multiple streams recording even with nothing playing.

Answers sourced from context7.com, www.reddit.com, www.reddit.com, www.reddit.com, www.reddit.com

Community

Collected 53 days ago - public community threads