Emby sur une TV sans application : votre appli TV dans le navigateur du téléviseur

Le problème : une TV avec un navigateur, mais sans application Emby

Si vous faites tourner Emby à la maison ou pour quelques amis, vous avez sûrement rencontré le même écueil : la TV du salon fonctionne très bien, mais il n’existe pas d’application Emby pour elle. Les anciens modèles Samsung (Tizen) et LG (webOS), certains Philips et les téléviseurs d’hôtel n’embarquent souvent qu’un navigateur, et pas grand-chose d’autre. Acheter une clé de streaming pour chaque écran devient vite lassant.

MediaLab TV prend un autre chemin. C’est une application web que vous ouvrez une fois dans le navigateur de la TV, que vous enregistrez en favori, et à partir de là la TV se connecte toute seule et affiche une interface façon Netflix pensée pour la télécommande. Elle porte votre nom, votre logo, vos couleurs et votre adresse, pas les nôtres. Ce guide explique comment l’installer sur Emby Server, la personnaliser et l’ouvrir sur une TV.

Prérequis

• Emby Server 4.10.1 ou plus récent.
• Une TV dotée d’un navigateur web. MediaLab TV est une application web ouverte dans le navigateur de la TV, pas une application issue de la boutique d’applications du téléviseur. Ce que la TV peut lire dépend de son navigateur ; le serveur transcode ce que le navigateur ne sait pas lire.
• Un compte MediaLab Works avec un abonnement actif, une licence à vie encore dans sa fenêtre de mises à jour, ou l’essai gratuit de 30 jours, pour pouvoir télécharger la DLL du plugin.
• Facultatif : Quick Connect pour « Sign in with your phone », Registration pour les nouveaux comptes, Cashier pour le paiement par QR code, et Smart Skip pour les boutons de saut.

Étape 1 : installer le plugin

1. Connectez-vous à votre compte MediaLab Works, ouvrez Licenses et téléchargez la DLL du plugin.
2. Copiez la DLL dans le dossier des plugins d’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 MediaLab TV dans le menu du tableau de bord Emby et cliquez sur License. Collez votre clé de licence et activez-la, ou saisissez votre e-mail pour démarrer l’essai ou acheter une licence. Le plugin contacte le serveur de licences, lie la clé à ce serveur 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 pendant 7 jours après la dernière vérification réussie ; passé ce délai, les TV n’affichent qu’un écran neutre « Service unavailable » jusqu’à ce que la vérification redevienne possible. Sans licence valide, les TV ne voient que cet écran neutre, sans votre nom ni votre logo.

Étape 2 : personnaliser l’image (branding)

Toujours dans le panneau MediaLab TV du tableau de bord, définissez :

• App name — le titre affiché sur la TV (par défaut « MediaLab TV »).
• Short name — le nom affiché dans la liste des appareils du serveur et comme nom de l’application enregistrée sur la TV.
• Line under the name et footer line — facultatifs, par exemple votre site web et comment joindre le support. Un pied de page vide affiche « Unofficial app, compatible with Emby servers » dans la langue de la TV.
• Colors — la couleur d’accent (boutons, focus) et le fond, au format #rrggbb. La couleur du texte est choisie automatiquement pour rester lisible.
• Language — automatique (la langue du navigateur de la TV), anglais ou roumain.
• Logo — PNG ou SVG, 512 Ko maximum ; une image carrée rend mieux. Les fichiers SVG contenant des scripts sont refusés.

Utilisez l’aperçu (preview) pour vérifier le résultat avant de cliquer sur Save. La section Buttons détermine si « Sign in with your phone » (affiché quand Quick Connect est installé et activé) et « New account (from the phone) » (affiché quand Registration est installé et ouvert aux inscriptions) apparaissent sur la TV.

Étape 3 : choisir l’adresse pour les TV

Le panneau affiche les adresses à ouvrir dans le navigateur de la TV :

• /emby/MediaLabTv/ sur l’adresse de votre serveur — fonctionne toujours.
• Votre propre chemin, par exemple /web/tv/index.html (le chemin par défaut est tv). Emby ne sert que les fichiers sous /web/, donc l’adresse se termine par index.html.

Cochez Put the redirect in place and restore it by itself after Emby updates et cliquez sur Apply. Le panneau affiche l’état de la redirection. Si les fichiers web d’Emby appartiennent à root (installation par paquet sous Linux), le plugin ne peut pas y écrire : le panneau affiche alors la commande exacte à exécuter une fois sur le serveur en administrateur, puis à nouveau après chaque mise à jour d’Emby.

Changer le chemin supprime l’ancienne page de redirection du plugin ; une page qui n’appartient pas au plugin n’est jamais touchée.

Étape 4 : configurer les options de connexion

• Sign in with your phone nécessite le plugin Quick Connect. Sur la page Quick Connect, réglez « After sign-in, the screen opens » sur /emby/MediaLabTv/, pour que la TV revienne à MediaLab TV après validation par le téléphone.
• New account (from the phone) nécessite Registration, ouvert aux inscriptions : la TV affiche un QR code et attend ; une fois le compte actif, la TV connecte le nouvel utilisateur.
• Payment nécessite Cashier : après l’inscription, la TV affiche le QR code de paiement et connecte l’utilisateur une fois le paiement effectué.

Sans ces plugins, la TV n’affiche que la connexion classique par nom d’utilisateur et mot de passe. Sous « After sign-in, open », vous pouvez aussi choisir l’interface MediaLab TV (par défaut) ou Emby Web, pour qu’Emby Web reste à un paramètre de distance.

Étape 5 : l’ouvrir sur la TV

Sur chaque TV, ouvrez l’adresse une fois dans le navigateur et enregistrez-la comme page de démarrage ou favori. Ensuite, la TV conserve le jeton du serveur, pas le mot de passe ; le jeton est vérifié à chaque démarrage, et s’il a été révoqué, la TV affiche le formulaire de connexion. Le réglage « Remember the password on TVs » (désactivé par défaut) ne conserve le mot de passe que pour les TV qui perdent sans cesse le jeton. Un mot de passe enregistré par la version 1.1 est utilisé une fois, si nécessaire, puis supprimé.

Un mode TV est choisi automatiquement sur les TV Tizen, webOS, Android TV, Google TV et Philips, ou basculé depuis le menu de profil. Il est dimensionné pour les écrans 720p, 1080p et 4K, avec des marges de sécurité et un focus de grande taille. Les flèches, OK, Retour (avec une question avant de quitter), les touches média, couleur, chaîne et chiffres fonctionnent, tout comme le pointeur de la LG Magic Remote.

Ce que vous apportent l’interface et le lecteur

L’interface propose une bannière rotative et des rangées pour Continuer à regarder, À suivre, les films et séries récemment ajoutés, chaque bibliothèque, Ma liste, les collections, les genres et la TV en direct (en ce moment, films ce soir, sport, enfants, à venir). Les pages de titres affichent la bannière, les notes, la distribution, les saisons et épisodes, les titres similaires et la bande-annonce locale. Il y a des grilles pour les films, les séries, les genres et les acteurs, une recherche avec clavier à l’écran, et des profils (« Who’s watching? »).

Le lecteur gère les pistes audio, les sous-titres, la reprise et l’épisode suivant, ainsi que les boutons Skip intro / recap / credits pilotés par les marqueurs d’Emby et Smart Skip. La lecture est signalée à Emby, elle apparaît donc dans Continuer à regarder partout. Un bouton d’en-tête (là où le navigateur le permet) et la touche F passent en plein écran ; sur une TV, ou lorsque l’application est ouverte depuis Quick Connect, le premier OK / clic passe en plein écran.

Conseils et dépannage

• La TV affiche « Service unavailable » : la licence n’est pas valide, ou le serveur n’a pas joint medialab.works depuis plus de 7 jours. Vérifiez la page License.
• L’adresse courte renvoie une erreur après une mise à jour d’Emby : exécutez la commande affichée dans le panneau (installations par paquet), ou cliquez de nouveau sur Apply.
• Une vidéo ne se lit pas dans le navigateur de la TV : vérifiez les réglages de lecture de cet utilisateur dans Emby (débit de streaming maximal, transcodage autorisé) ; le serveur transcode ce que le navigateur ne sait pas lire.
• Mises à jour : avec une licence valide, la page License peut installer une mise à jour ou revenir à la version précédente si une mise à jour pose problème. Redémarrez Emby dans les deux cas.
• Confidentialité : la TV ne communique qu’avec votre serveur Emby — pages, images et données viennent toutes de lui, et la page bloque tout ce qui vient d’ailleurs (pas de polices web, pas de CDN, pas de bandes-annonces externes). Sur le serveur, le plugin stocke les réglages de branding, le logo et la page de redirection sous /web/.
• État des tests : l’application a été testée dans un navigateur de TV Philips émulé ; les autres marques de TV sont gérées dans le code mais pas encore testées sur de vrais téléviseurs. Essayez d’abord sur un seul écran.

Conclusion

MediaLab TV transforme le navigateur déjà présent dans une TV ancienne ou d’hôtel en un vrai client pour votre serveur Emby : votre image, une interface adaptée à la télécommande, des boutons de saut et la connexion par téléphone, le tout servi depuis votre propre machine. Installez le plugin, définissez l’image et l’adresse, ouvrez le lien une fois sur chaque TV, et les écrans s’occupent du reste. Pour la référence complète, consultez le guide utilisateur et le changelog ; si quelque chose ne colle pas, la base de connaissances, la FAQ et la page de contact sont là pour vous.