🔧 Threadfin Configuratie Gids 2026

Threadfin is een fork van xTeVe (sinds 2022 inactief). Het draait als een service tussen je IPTV provider en je media server.

Wat doet het?

• Combineert meerdere M3U / Xtream bronnen tot één playlist
• Merged en mapt EPG XMLTV bronnen
• Emuleert HDHomeRun protocol (wat Plex/Jellyfin verwachten)
• Buffert streams (FFmpeg of native streaming mode)
• Beheert connection limits — voorkom je dat provider je blokkeert
• Filter kanalen — verwijder rotzooi voordat het in Plex komt
• Custom kanaal logos en groep-namen

version: "3"
services:
  threadfin:
    image: fyb3roptik/threadfin
    container_name: threadfin
    ports:
      - "34400:34400"
    volumes:
      - ./conf:/home/threadfin/conf
      - ./temp:/tmp/threadfin
    environment:
      - TZ=Europe/Amsterdam
      - PUID=1000
      - PGID=1000
    restart: unless-stopped

Start en open

Run docker-compose up -d en open http://server-ip:34400/web/.

Eerste login

Default geen user — direct toegang. Daarna in Settings → User: maak admin (sterk wachtwoord!).

1. Tab Playlist
2. Klik "+" knop
3. Naam: bv. "Provider X"
4. M3U URL: plak je URL
5. Update on start: aan
6. Auto-update interval: 24u standaard
7. Klik Save en wacht — kanalen worden geladen

Meerdere providers

Voeg meerdere playlists toe — Threadfin combineert ze. Handig als je 2 IPTV abo's hebt of een eigen XMLTV samenstelt.

Xtream Codes ipv M3U?

Zet je Xtream credentials om tot M3U URL: http://server.com/get.php?username=USER&password=PASS&type=m3u_plus&output=ts

1. Tab XMLTV
2. Klik "+" knop
3. Naam: bv. "EPG.best"
4. URL: plak XMLTV URL (zie EPG bronnen)
5. Update interval: 12u (genoeg)
6. Save

Meerdere EPG bronnen

Voeg meerdere XMLTVs toe — Threadfin merged automatisch. Eerst geladen bron wint bij conflict.

Cruciaal: koppel elk kanaal aan een EPG entry, anders krijg je geen programmagids in Plex/Jellyfin.

Auto mapping

1. Tab Mapping
2. Selecteer kanalen
3. Klik "Set XMLTV" → kies bron
4. Threadfin probeert te matchen op naam/tvg-id
5. Status kolom: ✅ matched of ⚠️ no match

Handmatig kanaal aan EPG koppelen

1. Klik op kanaal
2. XMLTV File: kies bron
3. Channel ID: type EPG channel id (bv. npo1.nl)
4. Save

Bulk actions

• Selecteer 20+ kanalen → "Activate" om in Plex/Jellyfin zichtbaar te maken
• "Deactivate" — verberg trash kanalen
• "Set channel number" — voor traditionele kanaalnummering
• "Change group" — herorganiseer in categorieën

Settings → Buffer. Twee opties:

• FFmpeg — gebruikt FFmpeg om elke stream te bufferen. Aanbevolen. Voorkomt buffering issues, betrouwbaarder.
• Streaming — directe pass-through. Lichter, maar problematisch bij sommige streams.

Voor de meeste gebruikers: FFmpeg mode aanzetten.

FFmpeg buffer settings

• Buffer Size: 1024 KB (default goed)
• Buffer Timeout: 1000 ms
• FFmpeg binary path: auto-detect of /usr/bin/ffmpeg

Settings → Streaming → Number of tuners. Hoeveel kanalen tegelijk kunnen streamen.

• Provider's connection limit: 3-5 meestal
• Stel in op je provider's max
• Lager = veiliger (krijg je niet geblokkeerd)
• Plex/Jellyfin gebruikt 1 tuner per simultane stream + 1 voor DVR opname

Sommige providers blokkeren standaard FFmpeg user-agent. Zet custom:

Mozilla/5.0 (Linux; Android 10) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4664.45 Mobile Safari/537.36

Of: VLC/3.0.16 LibVLC/3.0.16

1. Plex → Settings → Live TV & DVR → Set Up Plex DVR
2. Plex zoekt automatisch HDHomeRun op netwerk → vindt Threadfin op port 34400
3. Vindt het niet? Klik "Don't see your device?" → handmatig: http://server-ip:34400
4. Selecteer kanalen → Next
5. XMLTV: gebruik Threadfin's XMLTV: http://server-ip:34400/xmltv/threadfin.xml
6. Continue → kanalen mappen → Klaar

1. Dashboard → Live TV → Add tuner → HDHomeRun
2. URL: http://server-ip:34400
3. Save
4. Add EPG → XMLTV → http://server-ip:34400/xmltv/threadfin.xml

Filters

Tab Filter → maak rules om kanalen automatisch te tonen/verbergen:

• Filter: group-title contains "VOD" → action: hide
• Filter: name contains "##" → action: hide (verwijder placeholders)
• Filter: name contains "4K" → action: show + group "4K Kanalen"

Custom kanaal logos

Vervang lelijke logo URLs met eigen:

1. Mapping → kanaal → Logo URL
2. Plak eigen URL (bv. hosting via je NAS)
3. Of: gebruik tv-logo/tv-logos GitHub repo (gratis HD logos)

• Settings → Streaming → verhoog "Number of tuners"
• Provider's max connections bereikt — wacht tot anderen klaar zijn
• FFmpeg crash — restart Threadfin container

• Switch naar FFmpeg buffer mode
• Verhoog buffer size naar 2048 KB
• Check disk write speed naar /tmp/threadfin

• Mapping niet correct — check tab Mapping kolom "EPG"
• Tijdzone niet correct ingesteld (TZ env variable)
• XMLTV bron is zelf verouderd — probeer andere bron

• Plex op andere subnet dan Threadfin? Handmatig URL invoeren
• Firewall blokkeert port 34400
• Threadfin niet started — check Docker logs

Threadfin config staat in ./conf volume:

• Backup: kopieer hele conf folder
• Belangrijke files: settings.json, data.json, xepg.json
• Restore: stop container, vervang folder, start container

Wat is Threadfin?

Threadfin is een M3U- en EPG-proxy die je IPTV-playlist filtert, sorteert en aanbiedt als een HDHomeRun-achtige tuner. Zo koppel je IPTV netjes aan Plex, Jellyfin of Emby.

Waarvoor gebruik ik Threadfin?

Om uit een grote playlist alleen de gewenste kanalen te kiezen, ze te ordenen, en die selectie als Live TV-tuner aan je mediaserver te koppelen.

Wat is het verschil tussen Threadfin en xTeVe?

Threadfin is een actief onderhouden fork van xTeVe met extra functies en fixes. Voor nieuwe setups is Threadfin de logische keuze.

Hoe koppel ik Threadfin aan Plex?

Voeg Threadfin in Plex toe als een HDHomeRun-tuner en gebruik de bijbehorende XMLTV-gids voor de programmagegevens.