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.
Platform availability
Available on 3 of 10 platforms
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
Variants
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
- What are the top apps you guys use? : r/selfhosted - Reddit (reddit)
- Struggling with Threadfin docker container hanging : r/selfhosted - Reddit (reddit)
- Threadfin and Plex Settings that are working for me on Qnap NAS - Reddit (reddit)
- Multiple Plex Instances on one host with IPTV : r/PleX - Reddit (reddit)
- LiveTV using Xteve or Threadfin : r/unRAID - Reddit (reddit)
Collected 53 days ago - public community threads