Headend — la TV en direct d’Emby depuis des récepteurs Enigma2

Headend est un plugin Emby qui configure Emby Live TV à partir d’un récepteur Enigma2 (Vu+ Duo 4K, Uno, Solo et similaires, sous VTi, OpenATV, OpenPLi…) via OpenWebif. Les chaînes que votre récepteur accorde apparaissent dans la TV en direct d’Emby avec un EPG (guide TV), des logos de chaînes (picons) et le contrôle parental.

Ce qu’il fait

• Flux de chaînes depuis les tuners du récepteur, associés aux chaînes de la TV en direct d’Emby (sélection des bouquets).
• EPG (guide TV) : guide du récepteur plus des sources XMLTV externes optionnelles, fusionnés par chaîne.
• Picons : logos de chaînes du récepteur, ou depuis un lien que vous fournissez.
• Upscaling GPU (optionnel, NVENC) : les chaînes SD sont mises à l’échelle sur le serveur avant d’atteindre les clients.
• PIN adulte : les chaînes marquées adultes exigent un PIN dans Emby.
• Chien de garde du récepteur : détecte un récepteur figé et redémarre enigma2 ou le réveille de sa veille.

Prérequis

• Emby Server 4.10.1 ou plus récent, Emby Premiere pour les fonctionnalités de TV en direct.
• Récepteur Enigma2 avec OpenWebif 1.2.9 ou plus récent, joignable depuis le serveur Emby. Testé : Vu+ Duo 4K sous VTi 15.
• Optionnel : GPU NVIDIA avec NVENC pour l’upscaling.
• Optionnel : les segments courts (démarrage rapide) nécessitent un wrapper installé en root. Le chien de garde du récepteur (optionnel, désactivé sur les nouvelles installations) a besoin d’un SSH root vers le récepteur, sans mot de passe ou avec une clé.

Questions fréquentes

Comment configurer la TV en direct dans Emby avec un récepteur Enigma2 ? Installez Headend, saisissez l’adresse du récepteur et le port OpenWebif dans Dashboard → Plugins → Headend et choisissez les bouquets qui deviennent des chaînes. Ouvrez ensuite Live TV → Settings → Tuner devices, où Headend apparaît comme un tuner, et actualisez le guide. Chaque étape se trouve dans le guide d’installation.

Headend inclut-il des chaînes IPTV ou un abonnement ? Non. Headend diffuse les chaînes que votre propre récepteur Enigma2 accorde depuis le satellite ou le câble. Il ne vend ni n’inclut de chaînes, de listes de lecture ou d’abonnements IPTV.

Puis-je utiliser un EPG XMLTV ? Oui. Le guide propre du récepteur est activé par défaut ; vous pouvez ajouter des URL XMLTV externes et associer les chaînes par nom ou par référence de service. Les données du guide sont fusionnées par chaîne.

Puis-je enregistrer la TV en direct ? Oui, l’enregistrement fonctionne comme avec n’importe quel tuner Emby. Un tuner sur le récepteur ne porte qu’une chaîne à la fois (les chaînes du même transpondeur peuvent le partager).

Ce qu’il envoie où

Toutes les connexions ci-dessous ne démarrent qu’avec une licence valide.

• Votre récepteur Enigma2 / Vu+ (OpenWebif, votre adresse ; port web 80, flux 8001 ; authentification optionnelle) : informations, état d’alimentation, bouquets, chaînes, guide (toutes les 60 min), flux de chaînes. Les clients ne voient jamais l’adresse du récepteur — les flux passent par le serveur.
• SSH vers le récepteur (le chien de garde ; désactivé sur les nouvelles installations depuis la version 0.2.9 jusqu’à ce que l’administrateur l’active, conservé tel quel lors des mises à jour) : vérification TCP/HTTP toutes les 3 min ; après 2 échecs, la commande de redémarrage via ssh (utilisateur root par défaut, clé optionnelle), puis le redémarrage ; diagnostics collectés via SSH avant le redémarrage ; mise en veille après 10 min d’inactivité ; analyse nocturne des chaînes (02–06). La clé d’hôte SSH est vérifiée depuis la version 0.2.9 (trust on first use) : elle est enregistrée lors de la première connexion (ssh/known_hosts dans le dossier de données) et, si elle change, la commande n’est pas envoyée et un message clair est affiché ; l’empreinte enregistrée peut être consultée et oubliée depuis la page.
• Chaînes internet (iptv-org) — désactivées sur les nouvelles installations depuis la version 0.2.9 (la liste de première configuration explique ce qu’elles contactent ; lors des mises à jour, elles restent telles quelles), une fois la licence active (pays par défaut RO, MD) : télécharge le catalogue public iptv-org.github.io/api/*.json (au plus toutes les heures, avec ETag), vérifie les flux sur les hôtes tiers des chaînes (jusqu’à 64 Ko, toutes les 24 h / 6 h) et télécharge les logos de chaînes. Ces hôtes voient l’adresse IP de votre serveur. Peut être désactivé dans les paramètres. Vos propres listes M3U (URL ou fichier) sont optionnelles.
• Guide externe (EPG) — désactivé sur les nouvelles installations depuis la version 0.2.9 (case à cocher dans la liste de première configuration ; lors des mises à jour, il reste tel quel), quotidiennement à 04:00, avec 2 s entre les requêtes : www.programetv.ro, www.cinemagia.ro, epgshare01.online, open-epg.com (+ votre propre XMLTV, désactivé par défaut). Seules les pages/fichiers de programmes sont demandés ; aucune donnée utilisateur n’est envoyée. Les images de programmes sont transmises au serveur comme URL externes (le serveur peut les télécharger).
• Logos depuis un lien : uniquement sur action de l’administrateur (10 Mo max). Le plugin ne télécharge aucun pack de picons.
• Local : nvidia-smi pour la surveillance GPU.
• Les pages ne chargent aucune ressource externe.
• Plus le client de licences, le même dans chaque plugin : voir Licence et confidentialité dans nos plugins.

Stocké localement :

• Détails du récepteur (adresse, ports, utilisateur OpenWebif) dans la configuration du serveur ; depuis la version 0.2.9, le mot de passe OpenWebif est chiffré au repos dans secrets.enc.json dans le dossier de données du plugin (AES-256-GCM, clé aléatoire de secrets.key liée à l’identifiant du serveur, les deux fichiers en mode 600) et n’est jamais envoyé au navigateur (la page affiche seulement « set ✓ ») ; les versions antérieures le conservent en clair (dans la configuration du tuner Live TV). Pour SSH, seuls le chemin de la clé et la clé d’hôte publique du récepteur (ssh/known_hosts) sont stockés.
• PIN des chaînes adultes : hachage PBKDF2-SHA256 uniquement (200 000 itérations, salé). Depuis la version 0.2.10, les nouveaux PIN comportent au moins 6 chiffres (un PIN existant continue de fonctionner), et les tentatives erronées sont limitées par des verrouillages croissants qui survivent à un redémarrage.
• history.json : démarrages de chaînes des dernières 24 h et utilisation par minute (sans noms d’utilisateur) ; le guide (24 h d’historique), le catalogue iptv-org, le tampon en direct dans le cache du serveur.
• L’export « Backup » de l’administrateur contient la configuration du plugin ; depuis la version 0.2.10, il ne contient plus le hachage du PIN (les versions antérieures l’incluent). Les adresses des listes IPTV, des guides et des logos ne peuvent pas atteindre le réseau local ni le serveur lui-même (sauf le récepteur configuré), sauf si l’administrateur active « Local network IPTV sources » (activé automatiquement lors d’une mise à jour si des sources enregistrées sont déjà sur le réseau local) ; les adresses IPTV sont journalisées sans compte ni mot de passe.
• L’option « no B-frames for web playback » (activée par défaut) modifie les options d’encodage globales d’Emby ; la mise à jour automatique d’Emby ne peut être désactivée que par une action de l’administrateur.

Compatibilité des clients

• Les chaînes, le guide, les flux, le blocage des chaînes adultes et les préférences audio/sous-titres sont servis via la TV en direct du serveur : 🟢 devrait fonctionner dans toute application avec TV en direct.
• ✅ Emby Web : lecture réelle avec un Vu+ Duo 4K (VTi, OpenWebif), démarrage à froid 4.4–5.7 s.
• Applications Emby natives (Android, iOS, Android TV, Samsung, LG, Roku, Apple TV), navigateurs de TV : ❔ non testés.
• Navigateur uniquement : la page d’administration, la page « TV » (style Netflix), la page « Adult channels ». Dans les applications, le PIN est déverrouillé depuis un navigateur à /Headend/Unlock (par compte ; ✅ Chrome, téléphone).

Légende : ✅ vérifié (test de bout en bout ou sur appareil) · 🟢 côté serveur, fonctionne avec n’importe quel client (par conception, pas de test spécifique au client) · ➖ sans objet · ❔ non testé.

Licence

Une licence par serveur Emby. Mensuelle, annuelle ou à vie, ou incluse dans le pack Emby. Essai gratuit de 30 jours.