🎬 TVHeadend

Serveur TV et DVR pour la Freebox / TNT / Satellite : transforme un tuner réseau en backend Live TV pour Jellyfin, Plex ou Kodi.

📋 Informations Générales

Attribut	Valeur
Nom	TVHeadend
Slug	app-tvheadend
Description	Backend TV (DVB-S/C/T, ATSC, IPTV, SAT>IP) avec timeshift, EPG, enregistrement programmé et exposition M3U/XMLTV
Site officiel	https://tvheadend.org/
Repository	https://github.com/tvheadend/tvheadend
Stars	3 448 ⭐
Licence	GPL-3.0
Langage principal	C
Catégorie	Media Streaming
Tags	[catalogue, media-streaming, tvheadend, iptv, dvr, live-tv]

📝 Description

TVHeadend est la référence des serveurs TV pour self-hosting. Il prend en charge un large éventail de sources : cartes DVB-S/S2 (satellite), DVB-C (câble), DVB-T/T2 (TNT), ATSC (USA), mais aussi SAT>IP (tuners réseau comme la Freebox, la Livebox, le HDHomeRun), les flux IPTV en clair (M3U), et les adaptateurs USB économiques. Il expose ensuite ces chaînes sous plusieurs formats : HTTP HTSP (protocole natif pour Kodi/Kodi Addon), MPEG-TS multicast, et playlistes M3U + guide XMLTV.

L'interface web (port 9981) est austère mais exhaustive : configuration des réseaux, scan des multiplexes, mapping des chaînes, gestion de l'EPG, timeshift (pause du direct), enregistrements programmés, profiles de transcodage (utiles pour les clients légers). Le module "autorec" crée automatiquement des enregistrements pour tous les épisodes d'une série.

Le couplage classique est TVHeadend + Kodi (client HTSP) ou TVHeadend + Jellyfin (Live TV / DVR backend). Limites : interface vieillissante, peu de contributions récentes (mais projet stable), tuner USB souvent capricieux sur les noyaux récents.

🚀 Installation

Via Docker (recommandé)

# docker-compose.yml
version: "3.8"

services:
  tvheadend:
    image: linuxserver/tvheadend:latest
    container_name: tvheadend
    restart: unless-stopped
    ports:
      - "9981:9981"   # Web UI
      - "9982:9982"   # HTSP (Kodi)
    devices:
      - /dev/dvb:/dev/dvb      # cartes DVB USB/PCI
      - /dev/satip:/dev/satip  # si SAT>IP
    environment:
      PUID: 1000
      PGID: 1000
      TZ: Europe/Paris
      EPG_RUN: "yes"
    volumes:
      - ./config:/config
      - ./recordings:/recordings
      - /media/tv:/media/tv

Installation manuelle

Paquets officiels pour Debian/Ubuntu via le dépôt apt.tvheadend.org/stable. Sinon compilation depuis les sources (./configure --enable-ffmpeg_static). Doit tourner en root (ou avec capabilities) pour accéder à /dev/dvb.

⚙️ Configuration

Réseaux / Tuners : ajouter un tuner (DVB-S, IPTV automatique, SAT>IP). Pour la Freebox Pop/Delta/Revolution, activer le mode SAT>IP dans Freebox OS et pointer TVHeadend sur http://mafreebox.freebox.fr.
Muxes : lancer un scan initial (peut durer 10-30 min), puis maper les services sur les chaînes.
EPG : brancher grabbers (XMLTV, French EPG, OTA EIT). Pour la France : xmltv.fr via grabber.
DVR : configurer le dossier d'enregistrement, créer profils d'enregistrement (qualité, post-traitement).
Comptes : créer des utilisateurs avec droits (admin, viewer, recorder).
Exposure Jellyfin : URL http://tvheadend:9982, login/password, scan M3U interne.

🔗 Alternatives

Jellyfin Live TV natif — Intègre ses propres tuners, mais plus limité sur DVB et sans l'ergonomie HTSP de TVHeadend.
Plex DVR — Branché sur un tuner HDHomeRun uniquement, plus simple mais verrouillé.
NextPVR — Concurrent avec UI plus moderne, support DVB et IPTV, payant pour certaines fonctions.
DVBLast / OpenDVB — Solutions plus minimalistes, intégrables en bout de chaîne ffmpeg.

🔒 Sécurité

Changer immédiatement le mot par défaut (compte admin). L'UI web ne supporte pas l'authentification à deux facteurs, donc mot de passe fort obligatoire.
Placer TVHeadend derrière app-traefik avec auth basic ou app-authentik/app-authelia en amont.
Restreindre l'IP source : exposer HTSP uniquement en LAN ou via VPN.
Surveiller la taille du dossier recordings, qui grossit vite : prévoir cron de purge.

📚 Ressources

Site officiel : https://tvheadend.org/
Repository : https://github.com/tvheadend/tvheadend
Documentation : https://github.com/tvheadend/tvheadend/tree/master/docs
Addon Kodi : https://github.com/kodi-pvr/pvr.hts
Wiki FR : https://tvheadend.org/wiki

🔗 Pages Liées

cat-media-streaming (catégorie parente)
app-jellyfin — Couple fréquemment (backend Live TV)
app-kyoo — Autre plateforme streaming
app-traefik — Reverse proxy
recettes-docker-compose — Templates
securisation-home-lab — Bonnes pratiques

5.1 KiB Raw Blame History