Open Source · Android TV · Selbst gehostet

Live-TV vom eigenen Jellyfin-Server auf dem TV

Tellyfin ist eine native Android-TV-App, mit der sich dein Jellyfin Live-TV bedient wie jeder andere Receiver. Mit Hoch und Runter durch die Sender zappen, per Nummer direkt umschalten und den kompletten EPG-Programmführer aufrufen, ohne dabei deine Sendung aufzugeben.

  • Ab Android 5.0
  • Fire TV, Google TV, Android TV
  • MIT-Lizenz
  • v2.0.0

Funktionen

Alles, was ins Wohnzimmer gehört

Zappen, EPG und Suche, alles mit dem Steuerkreuz erreichbar, das meiste mit einem einzigen Tastendruck aus dem laufenden Stream.

Zappen wie an jedem Receiver

Hoch oder runter drücken, und der nächste Sender taucht in einem kleinen Banner auf, während das, was du geschaut hast, dahinter weiterläuft. Nach drei Sekunden wird umgeschaltet, mit OK sofort, und mit Zurück ist nichts passiert. Die CH-+/−-Tasten zappen direkt rüber, ohne Wartezeit.

EPG-Programmführer

Der komplette Programmführer: die Sender untereinander, die Sendezeit von links nach rechts, und eine Linie, die markiert, was gerade jetzt läuft. Mit Rechts oder der GUIDE-Taste öffnen, deine Sendung läuft beim Stöbern einfach weiter.

Startbildschirm

Eine Kartenreihe mit dem, was gerade läuft, Filterreiter für alle Sender und Favoriten, und eine Senderliste mit Fortschrittsbalken. Aufgebaut wie ein Google-TV-Start.

Gewichtete Suche

Sucht gleichzeitig in Sendernamen und Nummern, Sendungstiteln, Genres und Beschreibungen. Unabhängig von Umlauten und Akzenten, und was gerade läuft, steht oben.

Direktwahl

Du weißt die Sendernummer? Tipp sie auf der Fernbedienung ein und lande direkt dort, statt dich erst dahin zu zappen. Die Ziffern erscheinen groß im Bild, umgeschaltet wird mit OK oder nach zwei Sekunden von selbst.

Favoriten

Sender über das Schnellmenü markieren. Favoriten rutschen nach oben und bekommen einen eigenen Reiter. Gespeichert wird auf dem Gerät, nicht auf einem Server.

Bandbreitenlimit

In den Einstellungen Auto, 2, 4, 8, 12, 20 oder 40 Mbit/s wählen. Das Limit geht an den Transcode-Endpunkt von Jellyfin, damit auch eine langsame Leitung nutzbar bleibt.

Sauberes Netzwerk

Das Zugriffstoken steht im Authorization-Header und nie in einer URL, damit es nicht in Proxy-Logs landet. Kurzzeitige Streamfehler werden still wiederholt, bevor überhaupt eine Fehlermeldung erscheint.

Bedienung

Die ganze App auf einer Fernbedienung

Zappen wie am Receiver. Nichts davon braucht eine Tastatur, eine Handy-App oder eine Maus.

▲ ▼
Zum nächsten oder vorherigen Sender zappen, mit Vorschau
◀
Senderliste öffnen
▶
EPG-Programmführer öffnen
OK
Sendungsinfo, oder Vorschau bestätigen
MENU
Schnellmenü: Favorit, neu laden, Einstellungen
0 – 9
Direkt zu einer Sendernummer
CH +/−
Sofort umschalten, ohne Vorschau
BACK
Schließt, was gerade offen ist

Download

Zwei Wege zur Installation

Über einen Store, der die App für dich aktuell hält, oder als APK, das du selbst installierst.

Aus dem Store laden

Tellyfin ist im Amazon Appstore veröffentlicht, dort kann sie jeder installieren. Bei Google Play läuft noch ein geschlossener Test, da musst du erst beitreten. In beiden Fällen hält der Store die App aktuell, und beide Store-Varianten enthalten Absturzberichte.

Jetzt bei Google Play

Noch ein geschlossener Test. Opt-in-Seite öffnen, dem Test beitreten, danach Tellyfin wie gewohnt bei Google Play installieren.

Schon Tester? Zur Play-Seite

Erhältlich im Amazon Appstore

Im Appstore veröffentlicht, ohne Einladung. Such auf deinem Fire TV einfach nach Tellyfin und installier sie direkt vom Gerät aus.

Auf dem Gerät im Appstore öffnen

Google Play und das Google-Play-Logo sind Marken von Google LLC. Amazon, Amazon Appstore und alle zugehörigen Logos sind Marken von Amazon.com, Inc. oder seinen verbundenen Unternehmen.

Oder das APK selbst installieren

Zwei Varianten, ein Unterschied. Beide sind dieselbe App aus demselben Quellcode, signiert mit demselben Schlüssel. Nimm die, mit der du dich wohlfühlst. Eine ersetzt jeweils die andere.

Tellyfin

Empfohlen

Mit Absturzberichten, damit aus einem Absturz auf deinem Gerät ein Stacktrace wird, den ich auch beheben kann. Keine Analyse, keine Werbung, keine Aufzeichnung dessen, was du schaust.

APK herunterladen

Version 2.0.0 · tellyfin-sentry-2.0.0.apk

Tellyfin ohne Absturzberichte

Das SDK für Absturzberichte ist in dieser Variante gar keine Abhängigkeit, sein Code steckt also nicht im APK. Nichts zum Abschalten und nichts, das irgendetwas senden könnte.

APK herunterladen

Version 2.0.0 · tellyfin-nosentry-2.0.0.apk

Was die Varianten im Einzelnen senden: Datenschutzerklärung

Loslegen

In etwa fünf Minuten installiert

  1. 1

    Installation aus unbekannten Quellen erlauben

    Auf Fire TV: Einstellungen, Mein Fire TV, Entwickleroptionen, Apps unbekannter Herkunft. Auf Google TV und Android TV: Einstellungen, Apps, Sicherheit & Einschränkungen, Unbekannte Quellen.

  2. 2

    APK auf das Gerät bringen

    Mit der Downloader-App tellyfin.app/dl aufrufen, oder die Datei per USB oder über das Netzwerk kopieren.

  3. 3

    Installieren

    Die Datei mit der Downloader-App oder einem Dateimanager öffnen. Vom Rechner aus macht adb install tellyfin.apk dasselbe.

  4. 4

    Bei Jellyfin anmelden

    Serveradresse eingeben und anmelden, per Passwort oder mit Quick Connect. Die Live-TV-Sender werden direkt geladen.

Technik

Natives Android, sonst nichts

Kotlin und Jetpack-Bibliotheken von Google. Kein React Native, kein Flutter, kein WebView.

Jetpack Compose

Deklarative Oberfläche mit androidx.tv:tv-material für die TV-Komponenten und die Fokussteuerung.

Media3 / ExoPlayer

HLS-Wiedergabe mit Hardware-Dekodierung. Die Player-Ansicht bleibt außerhalb des Fokusbaums, damit die App jeden Tastendruck sieht.

Jellyfin Kotlin SDK

Sender, Programmdaten und Wiedergabestatus über jellyfin-core, gegen die API, die dein Server ohnehin bereitstellt.

DataStore

Serveradresse, Sitzung, letzter Sender, Favoriten und Bandbreitenlimit, gespeichert in der App-Sandbox auf dem Gerät.

Coroutines

Asynchrone Arbeit an die View-Models gebunden, inklusive Fortschrittsmeldungen und Vorschau-Countdown.

Coil

Laden und Zwischenspeichern der Senderlogos, den Auth-Header bekommen nur Anfragen an deinen eigenen Server.

Tellyfin steht unter der MIT-Lizenz. Issues und Pull Requests sind willkommen. github.com/Doxylamin/Tellyfin

Fragen

Vor der Installation

Kann ich damit zappen wie an einem normalen Receiver?

Ja, genau dafür ist sie da. Hoch oder runter zappt dich zum nächsten Sender und zeigt ihn dir in einem Banner, während deine Sendung darunter weiterläuft. So kommst du durch die ganze Senderliste, ohne aufzugeben, was du gerade schaust. Nach drei Sekunden wird umgeschaltet, mit OK sofort, mit Zurück gar nicht. Die CH-+/−-Tasten wechseln direkt, und wer die Sendernummer weiß, tippt sie einfach ein.

Was ist der Unterschied zur offiziellen Jellyfin-App für Android TV?

Die offizielle App gibt Live-TV einwandfrei wieder und hat einen Programmführer. Wenn dir das reicht, bleib dabei. Der Unterschied liegt im Umschalten. Dort öffnet Runter eine Liste von Sendern, durch die du scrollst und aus der du auswählst. In Tellyfin gehst du zum Sender nebenan und siehst ihn sofort, über dem, was ohnehin läuft. Tellyfin nutzt außerdem die CH-+/−-Tasten und die Direktwahl per Nummer, was die offizielle App nicht macht, und sie kann nur Live-TV statt deiner ganzen Mediathek.

Brauche ich ein Konto bei euch?

Nein. Es gibt keinen Tellyfin-Server und kein Tellyfin-Konto. Die App spricht mit deinem Jellyfin-Server. Die einzige weitere Anfrage ist eine Update-Prüfung gegen tellyfin.app beim Start, die die neueste Versionsnummer und einen GitHub-Downloadlink zurückgibt.

Kann sie aufnehmen, oder Catch-up und Timeshift?

Bisher nicht. Tellyfin gibt Live-Streams wieder und liest den Programmführer. Aufnahmen und Catch-up sind nicht umgesetzt, und wie viel davon überhaupt möglich wäre, hängt daran, was deine Live-TV-Quelle an Jellyfin liefert.

Funktioniert das mit IPTV oder einer M3U-Playlist?

Indirekt, und der Unterschied ist wichtig. Tellyfin ist kein IPTV-Player und nimmt selbst keine M3U-Datei entgegen. Sie zeigt das, was dein Jellyfin-Server als Live-TV bereitstellt. Wenn du dort also eine M3U-Playlist, einen XMLTV-Programmführer oder einen DVB-Tuner eingerichtet hast, tauchen diese Sender samt EPG-Daten automatisch in Tellyfin auf.

Läuft sie auf Handy oder Tablet?

Nein. Jeder Bildschirm ist für das Steuerkreuz und drei Meter Sitzabstand gebaut, und die App verlangt das Leanback-Feature. Sie wird deshalb nur auf TV-Geräten angeboten.

Welche Variante soll ich nehmen?

Wenn Absturzberichte für dich in Ordnung sind, nimm die empfohlene. Damit lassen sich Fehler auf echten Geräten deutlich leichter finden. Wenn nichts das Gerät verlassen soll, nimm die Variante ohne Absturzberichte. Sonst sind sie identisch.

Ist Sideloading sicher?

Die APKs werden von GitHub Actions direkt aus dem getaggten Commit im öffentlichen Repository gebaut, und der Workflow dafür liegt ebenfalls dort. Du kannst den Quellcode lesen, den Workflow lesen, oder mit ./gradlew assembleDebug selbst bauen.

Funktioniert sie mit einem älteren Jellyfin?

Sie zielt auf Jellyfin 10.11 und 12.0. Ältere Server können funktionieren, aber die Live-TV-Endpunkte haben sich zwischen den Versionen bewegt, und unterhalb von 10.11 ist nichts getestet.

Ist das eine offizielle Jellyfin-App?

Nein. Tellyfin ist ein unabhängiges Projekt, weder mit dem Jellyfin-Projekt verbunden noch von ihm unterstützt. Jellyfin ist deren Marke, nicht meine.