MeTube Smart-Home-Integration, kostenlos und Open Source
MeTube in Gladys: Download-Warteschlange, fertige und fehlgeschlagene Downloads, Video hinzufügen.
Veröffentlicht von guim31
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.2.0
- ★ 0
Bring deinen MeTube-Server (die selbst gehostete Weboberfläche von yt-dlp, um ein Video oder eine Playlist auf Abruf herunterzuladen) in dein lokales Netzwerk zu Gladys: die Download-Warteschlange mit ihrem Fortschritt, die fertigen und fehlgeschlagenen Downloads auf einem Dashboard, Szenen, die reagieren, wenn ein Download fertig wird oder fehlschlägt, und eine Aktion, die ein Video zu MeTube hinzufügt.
Die Integration wurde mit einem echten MeTube 2026.10.23 getestet (das offizielle Docker-Image, mit dem echten Download eines gemeinfreien Videos), aber noch nicht in einer echten Gladys-Installation: Rückmeldungen sind im Gladys-Forum oder in den Issues willkommen.
Lade nur herunter, wozu du berechtigt bist: gemeinfreie Videos, Videos unter freier Lizenz oder deine eigenen.
Was du brauchst
- Gladys Assistant 5.2.0 oder neuer.
- Einen MeTube-Server, von Gladys aus erreichbar (gleiches Netzwerk), auf
dem Port seiner Weboberfläche (standardmäßig
8081). - Wenn ein Reverse Proxy vor MeTube ein Passwort verlangt (MeTube selbst hat keines), diesen Benutzernamen und dieses Passwort.
Einrichtung
- Installiere die Integration aus dem Gladys-Katalog.
- Gib unter Konfiguration die Adresse von MeTube ein (zum Beispiel
192.168.1.2:8081; ohne Port wird8081verwendet). Läuft MeTube mit einemURL_PREFIX, füge es hinzu:192.168.1.2:8081/metube. Hinter einem Reverse Proxy, der ein Passwort verlangt, fülle auch Benutzername und Passwort aus. - Speichere und klicke auf Verbindung testen: Die Meldung unter der Schaltfläche nennt die Versionen von MeTube und yt-dlp sowie die laufenden, wartenden, abgeschlossenen und fehlgeschlagenen Downloads.
- Öffne den Tab Entdecken: ein Gerät für den Server. Klicke auf Hinzufügen, wähle einen Raum und speichere.
Optionen:
- Aktualisierungsintervall: 10 Sekunden bis 2 Minuten (standardmäßig 30 Sekunden). MeTube schreibt bei jeder Abfrage eine Zeile in sein eigenes Protokoll.
- Sprache der Funktionsnamen: die Namen, die die Funktionen beim Hinzufügen des Geräts erhalten (standardmäßig Französisch), und die Sprache der Meldungen der Szenenaktion.
Die Integration liest den Verlauf von MeTube (/history, genau die Liste, die
seine Webseite zeigt) und fügt Links über /add hinzu, wie die Webseite. Dabei löscht die Integration nie einen Download oder eine Datei.
Das Gerät
Ein Gerät, MeTube gefolgt von der Adresse des Servers:
| Funktion | Was sie liefert |
|---|---|
| Online | 1, wenn MeTube antwortet, sonst 0 |
| Laufende Downloads | Downloads, die laufen (Vorbereitung, Download) |
| Wartende Downloads | warten auf einen freien Platz oder auf den Start-Knopf |
| Abgeschlossene Downloads | fertige Downloads im Verlauf von MeTube |
| Fehlgeschlagene Downloads | fehlgeschlagene Downloads im Verlauf von MeTube |
| Fortschritt des aktuellen Downloads | in Prozent, 0, wenn nichts heruntergeladen wird |
| Download-Geschwindigkeit | in MB/s, alle Downloads zusammen |
| Aktueller Download | sein Titel, als Text („Kein Download“ im Leerlauf) |
| Zuletzt abgeschlossener Download | sein Titel, als Text |
Die fertigen und fehlgeschlagenen Downloads sind die, die MeTube in seinem Verlauf behält: Wenn du sie in MeTube löschst, sinken die Zahlen.
Dashboard
Das Widget MeTube-Downloads zeigt drei Kacheln (laufend, wartend, mit Fehler), die Warteschlange (Titel, Fortschritt und Geschwindigkeit, oder worauf sie wartet) und die letzten fertigen oder fehlgeschlagenen Downloads (Titel, Datei oder Fehler, Größe). Zwei Schaltflächen:
- Video hinzufügen: ein Formular mit dem Link und der Qualität; das Video wird zu MeTube hinzugefügt und startet sofort.
- Starten: nur sichtbar, wenn ohne automatischen Start hinzugefügte Downloads auf den Start-Knopf von MeTube warten; startet sie alle.
Füge es im Dashboard-Editor hinzu; es braucht keine Einstellung und funktioniert schon, bevor das Gerät hinzugefügt ist.
Szenen
Auslöser
- MeTube-Download abgeschlossen: Ein Download ist gerade fertig geworden, egal wer ihn hinzugefügt hat (die Webseite von MeTube, seine Browser-Erweiterung, Gladys). An die Aktionen weitergegebene Informationen: der Titel, der Link des Videos, der Dateiname und die Größe in MB.
- MeTube-Download fehlgeschlagen: Ein Download ist fehlgeschlagen (Link nicht unterstützt, Video nicht verfügbar oder privat, yt-dlp-Fehler). Informationen: der Titel, der Link und die Fehlermeldung.
Jeder Download wird nur einmal gemeldet, auch nach einem Neustart der Integration. Was MeTube schon im Verlauf hatte, als seine Adresse eingegeben wurde, wird nicht gemeldet; was fertig wurde, während die Integration gestoppt war, wird bei ihrem Neustart gemeldet. Derselbe Link, erneut heruntergeladen, wird erneut gemeldet.
Aktionen
- Video zu MeTube hinzufügen: Fügt ein Video oder eine Playlist zur Warteschlange von MeTube hinzu, sofort gestartet. Felder: der Link (eine Variable eines früheren Schritts geht auch) und die Qualität: bestes Video, 1080p, 720p, 480p oder nur Audio (MP3). Lehnt MeTube den Link ab, schlägt die Aktion mit seiner Meldung fehl.
Szenen-Ideen
- Wenn ein MeTube-Download fertig ist, schick dir eine Nachricht: „{title} ist bereit ({size_mb} MB)“.
- Wenn ein Download fehlschlägt, schick dir die Fehlermeldung, um den Link zu prüfen oder yt-dlp zu aktualisieren.
- Jeden Sonntag um 8 Uhr den Link einer wöchentlichen gemeinfreien Sendung oder eines Podcasts als reines Audio hinzufügen, um ihn später zu hören.
Fehlerbehebung
- „MeTube antwortet nicht“: Prüfe die Adresse und den Port (
8081) und ob Gladys den Server erreicht (gleiches Netzwerk, Firewall). - „Kein MeTube unter dieser Adresse“: Ein anderer Dienst antwortet auf
diesem Port, oder MeTube läuft mit einem
URL_PREFIX, das in der Adresse fehlt. - „Benutzername oder Passwort abgelehnt oder fehlend“: Ein Reverse Proxy verlangt ein Passwort; gib seinen Benutzernamen und sein Passwort ein.
- „Die Adresse leitet um“: Ein Reverse Proxy leitet auf eine Anmeldeseite oder auf HTTPS um; gib die direkte Adresse von MeTube in deinem Netzwerk ein.
- „MeTube hat den Link abgelehnt“: yt-dlp unterstützt die Seite nicht, oder das Video ist nicht verfügbar; die Meldung von MeTube sagt, warum.
- Mehr Details: Setze das
LOG_LEVELder Integration aufdebugund öffne ihre Protokolle.
Grenzen
- Ein Download wird bei der nächsten Abfrage erkannt: innerhalb des Aktualisierungsintervalls.
- Ein Download, den MeTube vor der nächsten Abfrage selbst aus seinem Verlauf löscht (
CLEAR_COMPLETED_AFTER), wird nicht gemeldet. - Höchstens 10 Ereignisse jeder Art pro Abfrage: darüber hinaus (eine Welle von Downloads) werden sie gezählt, nicht gemeldet.
- Die Integration löscht weder Downloads noch Dateien, bricht keinen Download ab und verwaltet nicht die Abonnements von MeTube. Um YouTube-Kanälen und Playlists automatisch zu folgen, siehe die Pinchflat-Integration.
- Ein Reverse Proxy mit Anmeldeseite (OAuth, Authelia…) wird nicht unterstützt: nur eine Basic-Authentifizierung (Benutzername und Passwort).
- Nicht verbunden mit MeTube, yt-dlp oder einer Videoseite.
Konfigurationseinstellungen
Diese Einstellungen fragt MeTube in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| MeTube-Server | section | Nein | Adresse der MeTube-Weboberfläche. Die Integration liest die Download-Warteschlange und fügt die Links hinzu, die du aus Gladys sendest. |
| Adresse | string | Nein | IP-Adresse oder Name des Servers, mit dem Port der Weboberfläche (standardmäßig 8081) und dem URL_PREFIX, falls MeTube eines hat. |
| Benutzername | string | Nein | Nur wenn ein Reverse Proxy vor MeTube ein Passwort verlangt (MeTube selbst hat keines). |
| Passwort | secret | Nein | Passwort des Reverse Proxys, mit dem Benutzernamen oben. |
| Aktualisierungsintervall | select | Nein | Wie oft die Warteschlange von MeTube gelesen wird: Fortschritt, fertige und fehlgeschlagene Downloads. |
| Sprache der Funktionsnamen | select | Nein | Namen der Funktionen beim Hinzufügen des Geräts und Texte, die die Integration sendet. |
So installierst du MeTube in Gladys
- Öffne in Gladys Integrationen: MeTube erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-metube: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-metube.
MeTube benötigt Gladys >=5.2.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
MeTube 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