Tvheadend Smart-Home-Integration, kostenlos und Open Source
Dein Tvheadend-Rekorder in Gladys: Aufnahmen, freier Speicher, Zuschauer und Szenen.
Veröffentlicht von guim31
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.1.0
- ★ 0
Tvheadend ist der freie TV-Server und Rekorder vieler Haushalte: Er liest DVB-Tuner (DVB-T, Satellit, Kabel) und IPTV-Listen, streamt die Sender an Kodi, einen Browser oder eine TV-App und nimmt Sendungen auf. Diese Integration bringt deinen Rekorder in Gladys: was gerade aufnimmt, was als Nächstes kommt, die fehlgeschlagenen Aufnahmen, den freien Speicher, wer was schaut, und Szenen, die auf eine startende, fertige oder fehlgeschlagene Aufnahme reagieren, auf jemanden, der fernsieht, oder auf eine volle Festplatte.
Du suchst die TV-Zeitschrift? Sieh dir die Integration Programme Télé an: Diese hier wiederholt sie nicht.
Getestet mit einem echten Tvheadend 4.3 in Docker (Image
lscr.io/linuxserver/tvheadend), mit einem IPTV-Netzwerk, das einen von ffmpeg
gelieferten Teststream liest: geplante, laufende, fertige und fehlgeschlagene
Aufnahmen, ein unterbrochener Stream, ein Zuschauer, ein Administratorkonto und
ein reines Aufnahmekonto. Ohne DVB-Tuner entwickelt: Rückmeldungen sind
willkommen in den Issues.
Was du brauchst
- Gladys Assistant 5.1.0 oder neuer.
- Tvheadend 4.2 oder neuer, von Gladys aus erreichbar (standardmäßig Port 9981).
- Einen Tvheadend-Benutzer mit Passwort und einen Zugangseintrag mit den Rechten Weboberfläche und Videorekorder (einfach, alle Aufnahmen, fehlgeschlagene Aufnahmen). Mit dem Recht Admin zeigt die Integration auch die Zuschauer und die belegten Tuner.
Erste Schritte
1. Einen Benutzer für Gladys anlegen
In Tvheadend, Konfiguration → Benutzer:
- Zugangseinträge → Hinzufügen: Benutzername
gladys, Rechte Weboberfläche und Videorekorder (auch „Alle Aufnahmen“ und „Fehlgeschlagene Aufnahmen“ ankreuzen), und Admin, wenn du die Zuschauer und die Tuner sehen willst. - Passwörter → Hinzufügen: derselbe Benutzername und ein Passwort.
2. Die Integration konfigurieren
Öffne in Gladys die Integration und fülle aus:
- Tvheadend-Adresse:
http://192.168.1.2:9981(eine Adresse ohne Port bekommt 9981; eine aus dem Browser kopierte URL funktioniert auch). - Benutzername und Passwort: der oben angelegte Benutzer. Digest- und Basic-Authentifizierung funktionieren beide.
- Aktualisierungsintervall: standardmäßig 30 Sekunden.
- Sprache der Namen: die Sprache der Funktionsnamen, der Daten und der Szenen-Ergebnisse.
Nutze dann Verbindung testen: Der Test liest Tvheadend und fasst zusammen, was aufnimmt, was folgt und wie viel Speicher frei ist.
3. Das Gerät hinzufügen
Öffne den Tab Entdecken: Der Server ist ein Gerät namens Tvheadend. Füge
es hinzu.
Die Geräte
| Funktion | Was sie sagt |
|---|---|
| Erreichbar | Ja, solange Tvheadend antwortet |
| Laufende Aufnahmen | Die gerade laufenden Aufnahmen |
| Geplante Aufnahmen | Die kommenden Aufnahmen (aktiviert) |
| Fehlgeschlagene Aufnahmen (24 h) | Mit Fehler beendete Aufnahmen der letzten 24 Stunden |
| Wird aufgenommen | „Titel (Sender)“ dessen, was aufnimmt („—“ sonst) |
| Nächste Aufnahme | „Titel · Sender · Fr. 20:30“ („—“, wenn nichts geplant ist) |
| Freier Speicher | Freier Speicher des Aufnahmeordners, in GB |
| Freier Speicher (%) | Dasselbe, in Prozent |
| Zuschauer | Leute, die einen Sender schauen (Kodi, Browser…), Admin-Konto |
| Belegte Tuner | Belegte Tuner (Eingänge), Administratorkonto |
Es gibt kein Gerät pro Tuner: Tvheadend listet nur die belegten Tuner.
Dashboard
Das Widget Tvheadend-Aufnahmen zeigt, was gerade aufnimmt (Titel, Sender und Ende), oder die nächste Aufnahme; Kacheln für die geplanten Aufnahmen, den freien Speicher und (Administratorkonto) die Zuschauer; dann eine Zeile pro laufender und kommender Aufnahme.
Szenen
Auslöser
Die Aufnahme-Auslöser lassen sich auf einen Sender beschränken: Gib seinen Namen so ein, wie Tvheadend ihn anzeigt (leer: alle Sender).
- Eine Aufnahme startet: Tvheadend beginnt aufzunehmen, mit Titel, Sender, Endzeit und geplanter Dauer.
- Eine Aufnahme ist fertig: Eine Aufnahme ist beendet und ihre Datei liegt auf der Festplatte, mit Titel, Sender, Dauer und Anzahl der Stream-Fehler.
- Eine Aufnahme schlägt fehl: Eine Aufnahme endete mit einem Fehler (kein Signal, kein Tuner frei, Datei nicht erstellt, Zeit verpasst…), mit dem Grund von Tvheadend, auf Englisch.
- Jemand schaut fern: Ein Client beginnt, einen Sender zu schauen, mit Sender, Tvheadend-Benutzer und Client. Auf einen Sender oder einen Benutzer beschränkbar. Braucht ein Administratorkonto.
- Freier Speicher unter einer Schwelle: Wähle 5, 10, 15, 20 oder 25 %; löst einmal aus, und erst wieder, wenn der freie Speicher darüber gestiegen ist.
Die Integration merkt sich, was sie gesehen hat: Ein Neustart von Gladys meldet keine Aufnahme zweimal, und eine inzwischen beendete Aufnahme wird einmal gemeldet.
Aktionen
- Sender jetzt aufnehmen: Nimmt einen Sender (Name oder Nummer, wie Tvheadend sie anzeigt) ab jetzt auf, 1 bis 720 Minuten, mit optionalem Titel. Gibt Titel, Sender, Start- und Endzeit.
- Aufnahmen-Überblick: Liest Tvheadend für die nächsten Aktionen: laufende und geplante Aufnahmen, was aufnimmt, die nächste Aufnahme (Titel, Sender, Zeit), den freien Speicher und einen fertigen Satz („1 laufende Aufnahme(n) (Tagesschau), nächste: Film · ARD · Fr. 20:30, 120 GB frei (24 %)“).
Szenen-Ideen
- Fehler-Alarm: „Eine Aufnahme schlägt fehl“ schickt dir eine Nachricht mit Titel und Grund, damit du sie erneut planst.
- Niemand zu Hause um 19:55: Wenn die Alarmanlage an ist, nimmt „Sender jetzt aufnehmen“ die Nachrichten 20 Minuten lang auf.
- Festplatte fast voll: „Freier Speicher unter einer Schwelle“ (10 %) schickt eine Benachrichtigung; eine Morgenszene sagt den Satz von „Aufnahmen-Überblick“.
- Kinomodus: „Jemand schaut fern“ mit dem Wohnzimmer-Konto dimmt das Licht.
Fehlerbehebung
- Tvheadend antwortet nicht: Prüfe Adresse und Port 9981 von dem Rechner aus, auf dem Gladys läuft.
- Benutzername oder Passwort abgelehnt (oder kein Recht auf die Weboberfläche): Tvheadend antwortet gleich auf ein falsches Passwort und auf ein Konto ohne das Recht Weboberfläche; prüfe beides.
- Das Konto hat kein Aufnahmerecht: Kreuze Videorekorder im Zugangseintrag des Benutzers an.
- Keine Zuschauer, keine Tuner: Das Konto ist kein Administrator (der Verbindungstest sagt es); der Rest funktioniert.
- Eine mittendrin unterbrochene Aufnahme ist „fertig“: Tvheadend selbst meldet einen während der Aufnahme verlorenen Stream als „Completed OK“; nur ein Stream, der beim Start fehlt, schlägt fehl.
Grenzen
- Ein Tvheadend-Server pro Integration.
- Tvheadend wird im gewählten Intervall gelesen (standardmäßig 30 Sekunden), nicht in Echtzeit: Ein Zuschauer, der kürzer als das Intervall schaut, kann übersehen werden.
- Der Grund eines Fehlers ist der von Tvheadend, auf Englisch.
- Kein Gerät pro Tuner, weder Signal noch SNR: Tvheadend listet nur die belegten Tuner.
- Die Szenen-Aktion plant eine Aufnahme; sie bricht keine ab und löscht keine.
- „Jemand schaut fern“ löst einmal pro Client aus (Adresse, Benutzer, Anwendung): Ein Senderwechsel löst ihn nicht erneut aus.
- Eine Aufnahme, deren Datei später verschoben oder gelöscht wird, bleibt eine fertige Aufnahme.
- Nicht mit dem Tvheadend-Projekt verbunden.
Konfigurationseinstellungen
Diese Einstellungen fragt Tvheadend in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Tvheadend-Server | section | Nein | Gib die Adresse von Tvheadend (Port 9981) und ein Konto mit Aufnahme- und Weboberflächen-Rechten ein. Ein Administratorkonto zeigt auch Zuschauer und belegte Tuner. Der Server erscheint im Tab „Entdecken“. |
| Tvheadend-Adresse | string | Ja | Adresse der Weboberfläche von Tvheadend (standardmäßig Port 9981). |
| Benutzername | string | Ja | Ein Tvheadend-Benutzer (Konfiguration → Benutzer → Zugangseinträge). |
| Passwort | secret | Ja | |
| Optionen | section | Nein | |
| Aktualisierungsintervall | select | Nein | Wie oft Tvheadend gelesen wird: jedes Mal ein paar leichte Anfragen. |
| Sprache der Namen | select | Nein | Sprache der Funktionsnamen (beim Anlegen des Geräts festgelegt), der Daten und der Szenen-Ergebnisse. |
So installierst du Tvheadend in Gladys
- Öffne in Gladys Integrationen: Tvheadend erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-tvheadend:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-tvheadend.
Tvheadend benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Tvheadend ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation