MediaLab TV für Jellyfin — Anleitung

Installation

Du brauchst Jellyfin Server 12.2 oder neuer und ein MediaLab-Works-Konto mit einer Lizenz, die das Plugin abdeckt (ein aktives Abonnement, eine Lifetime-Lizenz innerhalb ihres Update-Zeitraums, das Jellyfin-Paket oder den kostenlosen 30-tägigen Test).

Über dein Plugin-Repository (empfohlen). Jellyfin installiert und aktualisiert das Plugin dann von selbst.

1. Öffne in deinem MediaLab-Works-Konto Licenses → Jellyfin plugin repository und klicke auf Create address. Kopiere sie: Sie ist privat (sie enthält einen Token), 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 auf, die deine Lizenzen abdecken, und nur die Versionen, die sie erlauben. Seine Download-Links sind signiert und laufen nach wenigen Stunden ab, deshalb liest Jellyfin immer eine aktuelle Liste.

Über den öffentlichen Katalog. https://medialab.works/jellyfin/manifest.json listet jedes veröffentlichte MediaLab-Works-Plugin mit seinem öffentlichen Build; medialab Server fügt ihn von selbst hinzu. Du kannst ihn auf dieselbe Weise hinzufügen, um ein Plugin zu installieren, bevor du einen Schlüssel hast: Das Plugin fragt dann auf seiner Lizenz-Seite nach der Lizenz oder startet den Test. Bei einer Lifetime-Lizenz, deren Update-Zeitraum abgelaufen ist, bleib bei deinem privaten Repository, das nur die Versionen anbietet, die deine Lizenz erlaubt.

Manuell aus einer Zip-Datei.

1. Lade in Account → Licenses jf-tvapp_x.y.z.zip herunter (der SHA-256 der Datei wird neben dem Button angezeigt).
2. Entpacke sie in einen neuen Ordner MediaLab TV_x.y.z.0 im Jellyfin-Plugins-Ordner:
   • Linux (Paket): /var/lib/jellyfin/plugins/
   • Docker (offizielles Image): /config/plugins/ im Konfigurations-Volume
   • Windows: %ProgramData%\Jellyfin\Server\plugins\
3. Starte Jellyfin neu.

Lizenzaktivierung

1. Öffne die Plugin-Seite unter 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 Jellyfin-Server und zeigt die Lizenz als Active an.
3. Noch kein Schlüssel? Gib auf derselben Seite deine E-Mail-Adresse ein und starte den 30-tägigen kostenlosen Test (Karte erforderlich, heute nichts zu zahlen) oder kauf eine Lizenz; das Plugin aktiviert sich, sobald die Zahlung fertig ist.

Die Lizenz wird einmal am Tag und bei jedem Start von Jellyfin geprüft. Ohne Internet funktioniert das Plugin noch 7 Tage nach der letzten erfolgreichen Prüfung weiter. Ohne gültige Lizenz stoppt das Plugin seine Arbeit, und nur seine License-Seite funktioniert weiter (Test, Schlüssel, Verlängerung); es wird nichts gelöscht, und alles läuft weiter, sobald die Lizenz wieder gültig ist. Move license (release this server) auf derselben Seite gibt den Schlüssel für einen anderen Server frei.

Updates und Rollback

• Aus dem Repository: Jellyfin zeigt neue Versionen unter Dashboard → Plugins an und kann das Plugin automatisch aktualisieren; starte Jellyfin neu, um die neue Version zu laden.
• Über die License-Seite des Plugins: Mit gültiger Lizenz installiert Install update die neueste Version, die deine Lizenz erlaubt, und Roll back to x.y.z geht zur vorherigen Version zurück (zum Beispiel, wenn nach einem Update etwas nicht mehr funktioniert hat). Starte Jellyfin danach jeweils neu. Beide Pakete werden gegen die vom Lizenzserver veröffentlichte Prüfsumme geprüft.
• Eine Lifetime-Lizenz erhält die Versionen, die während ihres Update-Zeitraums erschienen sind; danach arbeitet das Plugin mit der letzten Version weiter, die es nutzen darf.
• Nach einem Rollback installiert Jellyfins geplante Aufgabe Update Plugins (beim Start und täglich) die neueste Version wieder, wenn dein Plugin-Repository in Jellyfin hinzugefügt ist. Um eine Weile auf der vorherigen Version zu bleiben, entferne die Auslöser dieser Aufgabe unter Dashboard → Scheduled Tasks und füge sie später wieder hinzu.

Quellcode

Der GPL-3.0-Quellcode jeder Version befindet sich in Account → Licenses (Source code) neben dem Download, als .tar.gz-Archiv aus dem exakten Commit dieser Version.

Branding

Öffne MediaLab TV im Jellyfin-Dashboard-Menü.

• App name: der Titel auf dem TV (Standard: „MediaLab TV“).
• Short name: wird in der Geräteliste des Servers und als Name der auf dem TV gespeicherten App angezeigt.
• Line under the name und footer line: optional (zum Beispiel deine Website und wie man den Support erreicht). Ein leerer Footer zeigt „Unofficial app, compatible with Jellyfin servers“ in der Sprache des TVs.
• Colors: die Akzentfarbe (Buttons, Fokus) und die Hintergrundfarbe als #rrggbb. Die Textfarbe wird automatisch so gewählt, dass 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.
• Buttons: „Sign in with your phone“ und „New account (from the phone)“.

Die Vorschau zeigt das Ergebnis, bevor du auf Save klickst.

Nach der Anmeldung

• „After sign-in, open“: die MediaLab-TV-Oberfläche (die Voreinstellung: Banner, Zeilen, Titelseiten, eigener Player und Skip-Buttons) oder Jellyfin Web.
• „Remember the password on TVs“ (standardmäßig aus): Der TV behält nur das Anmelde-Token des Servers, nicht das Passwort; schalte das nur für TVs ein, die das Token immer wieder verlieren. Ein von Version 1.1 gespeichertes Passwort wird, falls nötig, einmal benutzt und dann gelöscht.
• Auf dem TV schaltet das Profilmenü den TV-Modus (auf Tizen, webOS, Android TV, Google TV und Philips-TVs von selbst gewählt) und meldet ab.

Adresse für TVs

• /MediaLabTv/ auf deiner Serveradresse: funktioniert immer.
• Dein eigener Pfad, zum Beispiel /web/tv/ (der Standardpfad ist tv), direkt vom Plugin ausgeliefert: Die Adressleiste behält /web/tv/, es wird nichts in Jellyfins Dateien geschrieben und nach Jellyfin-Updates muss nichts erneut gemacht werden. Eine in Jellyfin gesetzte Base-URL wird berücksichtigt. Ein Pfad, der in Jellyfins Weboberfläche bereits existiert, wird nie überdeckt: Wähle einen anderen.

Öffne die Adresse auf jedem TV einmal im Browser und speichere sie als Startseite oder Favorit.

Anmeldung mit dem Handy und neue Konten

Beide nutzen Jellyfins eigenes Quick Connect: Schalte es in Dashboard → General ein.

• Sign in with your phone: Der TV zeigt einen 6-stelligen Code. Ein angemeldeter Benutzer bestätigt ihn auf dem Handy in der Jellyfin-App (Settings → Quick Connect). Mit installiertem Quick Connect by MediaLab zeigt der TV auch einen QR-Code, der die Bestätigungsseite öffnet.
• New account (from the phone): Mit Registration by MediaLab zeigt der TV einen QR-Code zur Registrierungsseite und einen Code, der im Formular eingetippt wird. Wenn das Konto aktiv wird (nach der Freigabe durch den Admin oder mit Cashier by MediaLab nach der Zahlung), meldet sich der TV von selbst an.

Fehlerbehebung

• Der TV zeigt „Service unavailable“: Die Lizenz ist nicht gültig, oder der Server hat medialab.works seit mehr als 7 Tagen nicht erreicht. Prüfe die License-Seite des Plugins.
• „Sign in with your phone“ fehlt: Quick Connect ist in Jellyfin ausgeschaltet (Dashboard → General).
• Die kurze Adresse zeigt Jellyfins eigene Seite: Dieser Pfad existiert bereits in der Weboberfläche; wähle einen anderen Pfad.
• Ein Video spielt im TV-Browser nicht: Prüfe die Wiedergabeeinstellungen für diesen Benutzer in Jellyfin (maximale Streaming-Bitrate, Transcoding erlaubt); der Server transkodiert, was der Browser nicht abspielen kann.