Jellyfin am Fernseher ohne App: eigene TV-App im Browser des Fernsehers

Das Problem: ein Jellyfin-Server und ein Fernseher ohne Jellyfin-App

Du betreibst Jellyfin zu Hause oder für eine kleine Gruppe von Nutzern. Der Server ist in Ordnung. Das Problem ist der Fernseher: ein älteres Samsung- oder LG-Gerät, ein Philips-Modell oder ein Hotel-Fernseher, der einen Browser hat, aber keine Jellyfin-App in seinem Store. Casting ist nicht immer eine Option, und eine zweite Box hinter jedem Fernseher willst du auch nicht.

MediaLab TV geht einen anderen Weg. Es ist ein Jellyfin-Plugin, das eine Web-App ausliefert, die einmal im Browser des Fernsehers geöffnet wird. Danach meldet sich der Fernseher selbst an und zeigt eine Oberfläche im Netflix-Stil, gebaut für die Fernbedienung, mit eigenem Player, Überspringen-Buttons und deinem Namen, Logo, deinen Farben und deiner Adresse statt unseren. Wenn du nach einer Alternative zur Jellyfin-TV-App für Geräte suchst, die nie eine bekommen werden, ist das der Ansatz: Der Browser ist der Client.

Eine ehrliche Anmerkung vorab: MediaLab TV ist keine App aus dem App-Store des Fernsehers. Es wurde in einem emulierten Philips-TV-Browser getestet; Samsung (Tizen), LG (webOS), Android TV / Google TV und echte Philips-Geräte werden im Code behandelt (TV-Modus, Fernbedienungstasten, Magic-Remote-Zeiger), sind aber noch nicht auf den Geräten geprüft. Was ein Fernseher abspielen kann, hängt von seinem Browser ab, und der Server transkodiert, was der Browser nicht abspielen kann.

Voraussetzungen

• Jellyfin Server 12.2 oder neuer, offiziell oder medialab Server, unter Linux, Windows oder Docker.
• Ein Fernseher mit Webbrowser. Das ist die ganze Client-Voraussetzung.
• Quick Connect in Jellyfin aktiviert (Dashboard → General), wenn du die Anmeldung per Handy und neue Konten vom Handy aus willst. Ohne das zeigt der Fernseher nur das übliche Formular für Benutzername und Passwort.
• Ein MediaLab-Works-Konto mit einer Lizenz, die das Plugin abdeckt: ein aktives Abo, eine Lifetime-Lizenz innerhalb ihres Update-Zeitraums, das Jellyfin-Bundle oder die kostenlose 30-Tage-Testversion.
• Optionale Extras: Quick Connect von MediaLab (QR-Code zur Bestätigungsseite), Registration von MediaLab (Anmeldung vom Handy) und Cashier von MediaLab (Bezahlung, bevor das Konto aktiv wird).

Schritt 1 — Plugin aus deinem privaten Repository installieren

Der empfohlene Weg lässt Jellyfin das Plugin selbst installieren und aktualisieren.

1. Öffne in deinem MediaLab-Works-Konto Licenses → Jellyfin plugin repository und klicke auf Create address. Kopiere die Adresse. Sie ist privat, weil sie ein Token enthält, also teile sie nicht; du kannst sie jederzeit neu erzeugen oder widerrufen.
2. Öffne in Jellyfin Dashboard → Plugins → Repositories, klicke auf +, gib einen Namen ein (zum Beispiel MediaLab Works), füge die Adresse ein und speichere.
3. Suche in Dashboard → Plugins → Catalog nach MediaLab TV, klicke auf Install und starte Jellyfin neu.

Das Repository listet nur die Plugins, die deine Lizenzen abdecken, und nur die Versionen, die sie erlauben. Seine Download-Links sind signiert und laufen nach einigen Stunden ab, damit Jellyfin immer eine frische Liste liest.

Wenn du magst, listet der öffentliche Katalog unter https://medialab.works/jellyfin/manifest.json jedes veröffentlichte MediaLab-Works-Plugin mit seinem öffentlichen Build (medialab Server fügt ihn selbst hinzu). Du kannst auch manuell installieren: Lade jf-tvapp_x.y.z.zip unter Account → Licenses herunter, entpacke es in einen neuen Ordner MediaLab TV_x.y.z.0 im Plugins-Ordner (/var/lib/jellyfin/plugins/ bei einer Linux-Paketinstallation, /config/plugins/ im Config-Volume beim offiziellen Docker-Image, %ProgramData%\Jellyfin\Server\plugins\ unter Windows) und starte Jellyfin neu.

Schritt 2 — Lizenz aktivieren

1. Öffne Dashboard → Plugins → MediaLab TV und klicke auf License.
2. Füge deinen Lizenzschlüssel ein und klicke auf Activate with key. Das Plugin kontaktiert den Lizenzserver, bindet den Schlüssel an diesen Server und zeigt die Lizenz als Active an.
3. Noch kein Schlüssel? Gib auf derselben Seite deine E-Mail ein und starte die 30-Tage-Testversion, oder kaufe eine Lizenz; das Plugin aktiviert sich selbst, sobald die Bezahlung erledigt ist.

Die Lizenz wird einmal täglich und bei jedem Jellyfin-Start geprüft. Ohne Internet läuft das Plugin nach der letzten erfolgreichen Prüfung noch 7 Tage weiter. Ohne gültige Lizenz sehen die Fernseher nur einen neutralen Bildschirm „Service unavailable“, auf Englisch und Rumänisch, ohne deinen Namen oder dein Logo — nichts wird gelöscht, und alles läuft wieder, sobald die Lizenz gültig ist. Move license (release this server) auf derselben Seite gibt den Schlüssel für einen anderen Server frei.

Schritt 3 — Branding einrichten

Öffne MediaLab TV im Menü des Jellyfin-Dashboards. Alles hier ist optional, aber das ist der Teil, den deine Nutzer tatsächlich sehen.

• App name: der Titel auf dem Fernseher (Standard „MediaLab TV“).
• Short name: erscheint in der Geräteliste des Servers und als Name der auf dem Fernseher gespeicherten App.
• Line under the name und footer line: zum Beispiel deine Website und wie man den Support erreicht. Eine leere Fußzeile zeigt „Unofficial app, compatible with Jellyfin servers“ in der Sprache des Fernsehers.
• Colors: die Akzentfarbe (Buttons, Fokus) und der Hintergrund, als #rrggbb. Die Textfarbe wird automatisch gewählt, damit sie lesbar bleibt.
• Language: automatisch (die Sprache des TV-Browsers), Englisch oder Rumänisch.
• Logo: PNG oder SVG, höchstens 512 KB; ein quadratisches Bild sieht am besten aus. SVG-Dateien mit Skripten werden abgelehnt.

Die preview zeigt das Ergebnis, bevor du auf Save klickst. Die Branding-Einstellungen und das Logo bleiben auf deinem Server.

Schritt 4 — Adresse für die Fernseher wählen

Zwei Adressen funktionieren:

• /MediaLabTv/ auf deiner Serveradresse: funktioniert immer.
• Dein eigener Pfad, zum Beispiel /web/tv/ (der Standardpfad ist tv), direkt vom Plugin selbst ausgeliefert. Die Adresszeile behält /web/tv/, nichts wird in Jellyfins Dateien geschrieben, und nach Jellyfin-Updates ist nichts zu wiederholen. Eine in Jellyfin gesetzte Basis-URL wird berücksichtigt. Ein Pfad, der in Jellyfins Weboberfläche bereits existiert, wird nie überschrieben, wähle bei einem Konflikt also einen anderen.

Auf medialab Server bekommt die App zusätzlich einen Eintrag im Menü der Benutzer.

Schritt 5 — Einmal auf jedem Fernseher öffnen

Öffne auf dem Fernseher den Browser, tippe die kurze Adresse einmal ein und speichere sie als Startseite oder Favorit. Das ist die ganze Einrichtung auf der Geräteseite.

Ein TV-Modus wird auf Tizen, webOS, Android TV, Google TV und Philips-Fernsehern von selbst gewählt oder im Profilmenü umgeschaltet. Er ist für 720p-, 1080p- und 4K-Bildschirme ausgelegt, mit sicheren Rändern und großem Fokus. Pfeiltasten, OK, Zurück (mit einer Rückfrage vor dem Verlassen), die Medien-, Farb-, Kanal- und Zifferntasten funktionieren, ebenso der Zeiger der LG Magic Remote. Vollbild gibt es über einen Button im Kopfbereich, wo der Browser es erlaubt, und mit der Taste F; auf einem Fernseher oder beim Öffnen über Quick Connect schaltet das erste OK / der erste Klick in den Vollbildmodus (seit 1.2.1).

Schritt 6 — Anmeldung festlegen

Der Fernseher speichert das Server-Token, nicht das Passwort. Das Token wird bei jedem Start geprüft; wurde es widerrufen, zeigt der Fernseher das Anmeldeformular. „Remember the password on TVs“ ist standardmäßig aus — schalte es nur für Fernseher ein, die das Token immer wieder verlieren.

Für die meisten Haushalte ist die Anmeldung per Handy die freundlichere Option:

• Sign in with your phone: Der Fernseher zeigt einen 6-stelligen Code. Ein angemeldeter Nutzer bestätigt ihn auf dem Handy in der Jellyfin-App (Settings → Quick Connect). Mit installiertem Quick Connect von MediaLab zeigt der Fernseher zusätzlich einen QR-Code, der die Bestätigungsseite öffnet.
• New account (from the phone): Mit Registration von MediaLab zeigt der Fernseher einen QR-Code zur Registrierungsseite und einen Code zum Eintippen ins Formular. Sobald das Konto aktiv ist — nach der Freigabe durch den Admin oder, mit Cashier von MediaLab, nach der Bezahlung — meldet sich der Fernseher selbst an.

Denk daran: Beides setzt voraus, dass Jellyfins Quick Connect unter Dashboard → General aktiviert ist.

Schritt 7 — Was deine Nutzer bekommen

Die Oberfläche ist eine eigene: ein wechselndes Banner und Reihen für Weiterschauen, Als Nächstes, kürzlich hinzugefügte Filme und Serien, jede Mediathek, Meine Liste, Sammlungen, Genres und Live-TV (läuft jetzt, Filme heute Abend, Sport, Kinder, demnächst). Titelseiten enthalten Hintergrundbild, Bewertungen, Besetzung, Staffeln und Episoden, ähnliche Titel und den lokalen Trailer. Es gibt Raster, eine Suche mit Bildschirmtastatur und Profile („Who's watching?“).

Auch der Player ist ein eigener: Tonspuren, Untertitel, Fortsetzen, nächste Episode und die Buttons Skip intro / recap / credits (Jellyfins Media Segments). Die Wiedergabe wird an Jellyfin gemeldet und erscheint so überall unter Weiterschauen. Wenn jemand den Standard-Client bevorzugt, schickt ihn die Einstellung „After sign-in, open“ stattdessen zu Jellyfin Web; die Oberfläche von MediaLab TV ist der Standard.

Tipps und Fehlersuche

• „Service unavailable“ auf dem Fernseher: Die Lizenz ist nicht gültig, oder der Server hat medialab.works seit mehr als 7 Tagen nicht erreicht. Prüfe die Seite License des Plugins.
• „Sign in with your phone“ fehlt: Quick Connect ist in Jellyfin nicht aktiviert. Schalte es unter Dashboard → General ein.
• Nach einem Update ist etwas kaputt: Nutze auf der License-Seite des Plugins Roll back to x.y.z (mit gültiger Lizenz) und starte Jellyfin neu. Ist dein privates Repository eingetragen, installiert Jellyfins geplante Aufgabe Update Plugins (beim Start und täglich) die neueste Version wieder — entferne ihre Auslöser unter Dashboard → Scheduled Tasks, wenn du eine Weile auf der vorherigen Version bleiben willst, und füge sie später wieder hinzu.
• Datenschutz: Der Fernseher spricht nur mit deinem Jellyfin-Server; die Seite blockiert alles von anderswo (keine Web-Fonts, kein CDN, keine externen Trailer). An medialab.works geht nur die Lizenzprüfung.
• Erwartungen an die Kompatibilität: Behandle den Browser als den Client. Wenn eine Datei nicht flüssig läuft, lass sie vom Server transkodieren, statt dem Fernseher die Schuld zu geben.

Fazit

Für einen Fernseher, der nie eine Jellyfin-App bekommen wird, ist ein browserbasierter Client mit eigener, fernbedienungsfreundlicher Oberfläche die pragmatische Antwort. MediaLab TV gibt dir das, dazu die Anmeldung per Handy über Quick Connect, Überspringen-Buttons auf Basis der Media Segments und ein Branding, das den Server nach deinem aussehen lässt. Installiere es aus deinem privaten Repository, setze Name, Logo und Farben, öffne /web/tv/ einmal auf jedem Fernseher — und das Gerät ist fertig. Die Bedienungsanleitung beschreibt jede Einstellung im Detail, das Changelog listet jede Version mit ihrem Quellcode, und die Wissensdatenbank und die FAQ sind da, wenn etwas nicht wie erwartet läuft; du kannst uns auch direkt kontaktieren.