TV en direct dans Emby avec un décodeur Enigma2 (Vu+) : chaînes, guide EPG et picons

Si vous utilisez déjà un décodeur Enigma2 (Vu+, Zgemma, GigaBlue et similaires) pour votre propre abonnement satellite ou câble, vous disposez déjà d'un tuner parfaitement fonctionnel. Le problème, c'est qu'Emby ne parle pas Enigma2. Headend est un plugin Emby qui fait le lien entre les deux : il lit votre récepteur via OpenWebif et expose les chaînes que votre récepteur capte comme chaînes Emby TV en direct, avec un guide, des logos de chaînes et le contrôle parental.

Une chose doit être claire avant de commencer : Headend ne fournit ni chaînes, ni playlists, ni aucun abonnement IPTV. Il diffuse ce que votre propre récepteur capte depuis le satellite ou le câble, sur du matériel que vous contrôlez. Si vous cherchez des chaînes à acheter, ce n'est pas ce produit, et ce tutoriel ne vous y aidera pas.

Ce guide couvre une installation complète d'Emby TV en direct avec un récepteur Enigma2 : connexion, choix des bouquets, fusion des données de guide, picons, PIN adultes et surveillance du récepteur.

Prérequis

• Emby Server 4.10.1 ou plus récent, avec Emby Premiere pour les fonctions TV en direct.
• Un récepteur Enigma2 sous une image récente (VTi, OpenATV, OpenPLi et similaires) avec OpenWebif 1.2.9 ou plus récent, joignable depuis le serveur Emby. La combinaison testée dans la documentation est un Vu+ Duo 4K sous VTi 15.
• En option : un GPU NVIDIA avec NVENC si vous souhaitez un upscaling des chaînes SD sur le serveur.
• En option : un accès SSH root au récepteur (sans mot de passe ou avec une clé) si vous voulez la surveillance du récepteur.
• Une licence Headend pour votre serveur Emby. Sans licence valide, le plugin est arrêté : les tâches automatiques ne s'exécutent pas et ses pages répondent en indiquant la raison, donc commencez par l'étape de licence.

Étape 1 : installer le plugin et activer la licence

1. Connectez-vous à votre compte MediaLab Works, ouvrez Licences et téléchargez la DLL du plugin. Elle est disponible avec un abonnement actif, une licence à vie dans sa fenêtre de mise à jour, ou pendant l'essai gratuit de 30 jours.
2. Copiez la DLL dans le dossier des plugins Emby et redémarrez Emby Server :
   • Linux (paquet) : /var/lib/emby/plugins/
   • Docker : le dossier plugins dans votre volume de configuration Emby
   • Windows : %AppData%\Emby-Server\programdata\plugins\
3. Ouvrez Emby Dashboard → Plugins, cliquez sur le plugin, collez votre clé de licence et enregistrez. Le plugin contacte le serveur de licences, lie la clé à ce serveur Emby et affiche la licence comme Active.

La licence est vérifiée une fois par jour et à chaque démarrage d'Emby. Sans internet, le plugin continue de fonctionner 7 jours après la dernière vérification réussie ; ensuite il s'arrête jusqu'à pouvoir vérifier à nouveau. Rien n'est supprimé, et tout reprend dès que la licence est de nouveau valide.

Étape 2 : se connecter au récepteur

Ouvrez Dashboard → Plugins → Headend. Dans la section Receiver, saisissez l'IP ou le nom d'hôte, le port OpenWebif (80 par défaut) et un utilisateur et mot de passe si votre OpenWebif a l'authentification activée. Cliquez sur Test connection.

Si le test échoue, vérifiez depuis l'hôte Emby lui-même qu'OpenWebif répond, par exemple en ouvrant http://receiver/api/getallservices dans un navigateur. C'est aussi la première étape de dépannage plus tard si aucune chaîne n'apparaît.

Une remarque sur les identifiants : 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 avec une clé aléatoire liée à l'identifiant du serveur, fichiers en mode 600) et n'est jamais envoyé au navigateur. Les versions antérieures le conservent en clair dans la configuration du tuner TV en direct, donc mettez à jour si possible.

Étape 3 : choisir les bouquets

Dans la section Bouquets, choisissez les bouquets qui deviennent des chaînes Emby. Les numéros de chaîne suivent l'ordre des bouquets : c'est donc ici que vous décidez de l'ordre des chaînes que verront vos utilisateurs. Restez délibéré : une liste courte et ordonnée de bouquets est plus facile à parcourir avec une télécommande que l'intégralité de l'offre de votre récepteur.

Étape 4 : données de guide (EPG)

L'EPG du récepteur est activé par défaut, vous obtenez donc un guide sans effort supplémentaire. Pour une meilleure couverture, vous pouvez ajouter des URL XMLTV externes et mapper les chaînes par nom ou par référence de service. Les données de guide sont fusionnées par chaîne, de sorte que les données du récepteur et vos sources XMLTV se complètent au lieu de s'écraser mutuellement.

Soyez conscient de ce que contacte l'option de guide externe. Sur les nouvelles installations depuis la version 0.2.9, le guide externe est désactivé par défaut et peut être activé dans la liste de vérification de la première configuration ; sur les mises à jour, il reste tel quel. Lorsqu'il est activé, il s'exécute chaque jour à 04:00 avec 2 secondes entre les requêtes et contacte www.programetv.ro, www.cinemagia.ro, epgshare01.online et open-epg.com, plus vos propres sources XMLTV (désactivées par défaut). Seules des pages de programmes et des fichiers sont demandés ; aucune donnée utilisateur n'est envoyée. Les images de programmes sont transmises au serveur sous forme d'URL externes, et le serveur peut les télécharger.

Étape 5 : picons (logos de chaînes)

Dans la section Picons, vous pouvez utiliser les picons déjà présents sur votre récepteur, ou indiquer au plugin un dossier local de picons. C'est tout : le plugin ne télécharge lui-même aucun pack de picons, et les logos issus d'un lien ne sont récupérés que sur action d'un administrateur, avec une limite de 10 Mo.

Étape 6 : upscaling NVENC en option

Si votre serveur dispose d'un GPU NVIDIA avec NVENC, vous pouvez activer l'upscaling, choisir la résolution cible et fixer un nombre maximal de flux simultanés. Cela met à l'échelle les chaînes SD sur le serveur avant qu'elles n'atteignent les clients. Si la lecture saccade ensuite, baissez la résolution cible ou désactivez l'upscaling et vérifiez le réseau entre le récepteur et le serveur.

Étape 7 : chaînes adultes et PIN

Marquez les chaînes à placer derrière le contrôle parental et définissez un PIN. Seul un hash PBKDF2-SHA256 du PIN est stocké (200 000 itérations, avec sel). Depuis la version 0.2.10, les nouveaux PIN doivent comporter 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. Dans les applications, le PIN se déverrouille depuis un navigateur à l'adresse /Headend/Unlock, par compte.

Étape 8 : la surveillance du récepteur (en option)

Un récepteur figé signifie un flux TV en direct mort. La surveillance est optionnelle et désactivée sur les nouvelles installations depuis la version 0.2.9 (elle reste telle quelle sur les mises à jour). Lorsqu'elle est activée, vous définissez l'intervalle de vérification et l'action : redémarrer enigma2 ou sortir le récepteur du mode veille.

Elle fonctionne via SSH vers le récepteur, et nécessite donc un accès SSH root sans mot de passe ou avec une clé. Elle effectue une vérification TCP/HTTP toutes les 3 minutes ; après 2 échecs, elle envoie la commande de redémarrage via ssh (utilisateur root par défaut, clé en option), puis redémarre, en collectant des diagnostics via SSH avant le redémarrage. Elle gère aussi la veille après 10 minutes d'inactivité et une recherche de chaînes nocturne entre 02:00 et 06:00. Depuis la version 0.2.9, la clé d'hôte SSH est vérifiée (trust on first use) : elle est enregistrée à la première connexion dans ssh/known_hosts dans le dossier de données, et si elle change, la commande n'est pas envoyée et un message clair s'affiche. Vous pouvez consulter et oublier l'empreinte enregistrée depuis la page.

Étape 9 : ajouter le tuner dans Emby et rafraîchir le guide

Allez dans Live TV → Settings → Tuner devices. Headend y apparaît comme un tuner. Ajoutez-le, puis rafraîchissez le guide.

Usage quotidien et limites

Les chaînes et le guide apparaissent dans Live TV, et l'enregistrement fonctionne comme avec n'importe quel tuner Emby. Gardez le calcul des tuners en tête : un tuner sur le récepteur transporte une chaîne à la fois, même si les chaînes d'un même transpondeur peuvent le partager. Planifiez vos enregistrements simultanés en conséquence.

La prise en charge des clients passe par la TV en direct du serveur : chaînes, guide, flux, blocage des chaînes adultes et préférences audio/sous-titres devraient fonctionner dans toute application disposant de la TV en direct. Emby Web est vérifié de bout en bout avec un Vu+ Duo 4K (VTi, OpenWebif), avec un démarrage à froid de 4,4 à 5,7 s. Les applications natives et les navigateurs de TV ne sont pas testés. La page d'administration, la page « TV » et la page « Adult channels » sont réservées au navigateur.

Astuces et dépannage

• Aucune chaîne : vérifiez qu'OpenWebif est joignable depuis l'hôte Emby (http://receiver/api/getallservices), puis revérifiez l'adresse et le port du récepteur dans le plugin.
• Aucune donnée de guide : assurez-vous que l'EPG du récepteur est activé, puis ajoutez des URL XMLTV et vérifiez le mapping des chaînes par nom ou référence de service. Rappelez-vous que le guide externe est désactivé par défaut sur les nouvelles installations.
• Saccades : baissez la cible d'upscaling ou désactivez l'upscaling, et vérifiez le chemin réseau entre le récepteur et le serveur.
• Le récepteur se fige : activez la surveillance pour qu'elle redémarre enigma2 lorsque les flux cessent de répondre.
• Tuner occupé : une autre chaîne utilise déjà le tuner. Attendez qu'elle se termine ou enregistrez depuis le même transpondeur.
• Confidentialité : les clients ne voient jamais l'adresse du récepteur ; les flux passent par le serveur. Vos propres listes M3U sont optionnelles, et les chaînes internet (iptv-org) sont désactivées sur les nouvelles installations depuis la version 0.2.9.

Conclusion

Headend vous permet de continuer à utiliser le récepteur que vous possédez déjà comme tuner légal pour Emby TV en direct, avec vos bouquets, un guide fusionné, des picons et une surveillance qui vous épargne un déplacement au grenier. Commencez par la page produit, suivez le guide utilisateur pour les champs exacts, et gardez le changelog à portée de main lors des mises à jour. Si quelque chose ne correspond pas, la base de connaissances et la FAQ sont l'étape suivante, et vous pouvez toujours nous contacter.