📡 Tvheadend Complete Setup 2026

Tvheadend (TVH) is een TV streaming server backend voor Linux. Het:

• Accepteert input van DVB-T/C/S tuners, IPTV (M3U), SAT>IP, en Unix pipes
• Beheert kanalen + EPG centraal
• Plant DVR opnames
• Levert kanalen aan clients (Kodi, Plex, Jellyfin) via HTSP protocol of HTTP streams
• Heeft web interface voor management
• Open source sinds 2012, actief maintained

Vergeleken met Threadfin: Tvheadend is veel krachtiger (multi-tuner, DVB support) maar complexer. Threadfin is simpeler voor IPTV-only.

• Linux server — Ubuntu Server 22.04 LTS of 24.04 LTS
• Raspberry Pi 4/5, NAS, of x86 mini-PC werkt prima
• Minimaal 2GB RAM, 8GB opslag voor OS
• Voor DVR: extra opslag (USB/SMB/NAS)
• M3U URL en/of DVB tuner hardware

sudo apt update
sudo snap install tvheadend

Open daarna in browser: http://server-ip:9981

# Voeg Tvheadend PPA toe
sudo add-apt-repository ppa:tvheadend/tvheadend
sudo apt update
sudo apt install tvheadend

# Tijdens install: vul admin user + password in
# Service start automatisch op port 9981 (web) + 9982 (HTSP)

version: "3"
services:
  tvheadend:
    image: linuxserver/tvheadend
    container_name: tvheadend
    network_mode: host
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Amsterdam
    volumes:
      - ./config:/config
      - ./recordings:/recordings
    restart: unless-stopped

1. Open http://server-ip:9981 in browser
2. Wizard start automatisch:
   • Language → English (NL nog niet volledig)
   • Network IP → laat default (auto-detect)
   • Admin user → gebruikersnaam + sterk wachtwoord
   • User access → maak read-only user voor apps
3. Wizard vraagt om tuner — kies "IPTV" (geen DVB hardware) of "DVB" als je tuner card hebt

1. Configuration → DVB Inputs → Networks → Add
2. Type: IPTV Network
3. Vul in:
   • Network name: bv. "Provider X"
   • Maximum Input streams: 5 (aantal simultane)
   • Maximum Number of services: 5000 (kanalen)
   • Service identifier: auto
4. Save
5. Tab Muxes → Add → Auto IPTV Network → URL = je M3U URL
6. Save → Tvheadend scant kanalen automatisch

1. Configuration → Channel/EPG → EPG Grabber Modules
2. Activeer External: XMLTV
3. Tab EPG Grabber → Cron multi-line: 0 */6 * * * (elke 6 uur)
4. External Grabber Path: standaard /usr/bin/tv_grab_xmltv
5. Of: gebruik xmltv socket import van een eigen script
6. Save → manual trigger eerste run

Channel mapping

Configuration → Channel/EPG → EPG Grabber Channels → match channel met EPG ID.

1. Configuration → Channel/EPG → Channels
2. Voor elk kanaal: dubbelklik om te bewerken
   • Name (toon naam)
   • Number (kanaal nummer)
   • Icon URL (logo)
   • EPG source mapping
3. Of bulk: Configuration → Channel/EPG → Services → "Map services" knop

1. Configuration → Recording → Digital Video Recorder Profiles
2. Edit default profile:
   • Recording system path: /recordings/$t
   • Title: enabled
   • Subtitle: enabled
   • Episode: enabled
   • Pre-recording padding: 2 min
   • Post-recording padding: 10 min
3. Save
4. Plan opname: ga naar EPG → klik op programma → "Record"

1. In Kodi: Settings → Add-ons → My Add-ons → PVR clients
2. Selecteer Tvheadend HTSP Client
3. Enable + Configure:
   • Host: server-IP
   • HTTP port: 9981
   • HTSP port: 9982
   • Username + Password van Tvheadend
4. Save → Restart Kodi
5. TV menu in Kodi toont nu Tvheadend kanalen + EPG

Tvheadend levert HTTP M3U via http://server-ip:9981/playlist/channels.m3u en XMLTV via http://server-ip:9981/xmltv/channels.

Of: gebruik Threadfin als tussenlaag voor HDHomeRun emulation richting Plex.

"No free tuner"

• Verhoog "Maximum Input streams" in IPTV network
• Check of meerdere clients dezelfde tuner claimen

Stream stutter

• Configuration → Stream → Stream Profile → MPEG-TS Pass-through
• Vermijd transcoding tenzij echt nodig

EPG mist

• Check EPG Grabber log: Configuration → Debugging
• Channel EPG mapping verkeerd → handmatig per channel

Wat is TVHeadend?

TVHeadend is een gratis, open-source TV-backend (server) voor live televisie en opnames. Het draait op Linux, een NAS of een Raspberry Pi en bedient meerdere clients.

Kan TVHeadend IPTV (M3U) streams aan?

Ja. Via een "IPTV Automatic Network" voer je je M3U-URL in, waarna TVHeadend de kanalen importeert en aan je clients aanbiedt.

Welke clients werken met TVHeadend?

Onder andere Kodi (via de HTSP/PVR-addon), Jellyfin en diverse mobiele apps kunnen verbinden met een TVHeadend-server.

Is TVHeadend moeilijk op te zetten?

Het is vrij technisch en gericht op gevorderde gebruikers. Wil je iets eenvoudigers, kijk dan naar onze Jellyfin-setup.