# 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. It is open source and self-hosted, installable on Docker Hub, Proxmox, ZimaOS and Unraid.

Canonical page: https://ourlocalhost.com/app/754/threadfin

## Description

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 9 platforms: Unraid, ZimaOS, Proxmox.

## Health score

58/100 (Fair), based on 4 of 5 factors.
- Maintained: 34 (last commit 390 days ago)
- Popular: 65 (1,730 GitHub stars)
- Easy to install: 55 (3 install platforms, install notes, Docker image)
- Security check: 100 (no serious findings, CI, tests)

## Links

- GitHub: https://github.com/Threadfin/Threadfin
- Docker Hub: https://hub.docker.com/r/fyb3roptik/threadfin
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=threadfin
- ZimaOS: https://github.com/IceWhaleTech/CasaOS-AppStore/tree/main/Apps/Threadfin
- Unraid: https://ca.unraid.net/apps/threadfin-0zwbhsx0jsbxj1?q=Threadfin

## 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.

## Alternatives

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

---
Source: Our Local Host (https://ourlocalhost.com/app/754/threadfin), the self-hosted and open-source app directory.