---
title: TVHeadend
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, media-streaming, tvheadend, iptv, dvr, live-tv]
confidence: high
contested: false
sources:
  - https://selfh.st/apps/?tag=Media+Streaming
  - https://github.com/tvheadend/tvheadend
  - https://tvheadend.org/
---

# 🎬 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é)

```yaml
# 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
