Intégration domotique MeTube, gratuite et open source

MeTube dans Gladys : file de téléchargements, terminés, erreurs, ajout d'une vidéo par scène.

• Publiée par guim31
• Appareils
• Version 1.0.0
• Nécessite Gladys >=5.2.0
• ★ 0

Voir sur GitHubToutes les intégrations

Retrouvez votre serveur MeTube (l'interface web auto-hébergée de yt-dlp, pour télécharger une vidéo ou une playlist à la demande) dans Gladys, sur votre réseau local : la file de téléchargements et sa progression, les téléchargements terminés et en erreur sur un tableau de bord, des scènes qui réagissent quand un téléchargement se termine ou échoue, et une action qui ajoute une vidéo à MeTube.

L'intégration a été testée contre un vrai MeTube 2026.10.23 (l'image Docker officielle, avec le téléchargement réel d'une vidéo du domaine public), pas encore dans une vraie installation de Gladys : vos retours sont les bienvenus sur le forum Gladys ou dans les issues.

Ne téléchargez que ce que vous avez le droit de télécharger : vidéos du domaine public, sous licence libre, ou les vôtres.

Ce qu'il faut

• Gladys Assistant 5.2.0 ou plus récent.
• Un serveur MeTube, joignable depuis Gladys (même réseau), sur le port de son interface web (8081 par défaut).
• Si un proxy inverse devant MeTube demande un mot de passe (MeTube lui-même n'en a pas), cet identifiant et ce mot de passe.

Installation

1. Installez l'intégration depuis le catalogue de Gladys.
2. Dans Configuration, saisissez l'Adresse de MeTube (par exemple 192.168.1.2:8081 ; sans port, 8081 est utilisé). Si MeTube tourne avec un URL_PREFIX, ajoutez-le : 192.168.1.2:8081/metube. Derrière un proxy inverse qui demande un mot de passe, remplissez aussi l'Identifiant et le Mot de passe.
3. Enregistrez, puis cliquez sur Tester la connexion : le message sous le bouton donne les versions de MeTube et de yt-dlp, et les téléchargements en cours, en attente, terminés et en erreur.
4. Ouvrez l'onglet Découverte : un appareil pour le serveur. Cliquez sur Ajouter, choisissez une pièce et enregistrez.

Options :

• Intervalle de rafraîchissement : de 10 secondes à 2 minutes (30 secondes par défaut). MeTube écrit une ligne dans son propre journal à chaque lecture.
• Langue des noms de fonctionnalités : les noms donnés aux fonctionnalités à l'ajout de l'appareil (français par défaut), et la langue des messages de l'action de scène.

L'intégration lit l'historique de MeTube (/history, la liste même qu'affiche sa page web) et ajoute des liens par /add, comme la page web. Elle ne supprime jamais un téléchargement ni un fichier.

L'appareil

Un appareil, MeTube suivi de l'adresse du serveur :

Fonctionnalité	Ce qu'elle donne
En ligne	1 quand MeTube répond, 0 sinon
Téléchargements en cours	téléchargements qui tournent (préparation, téléchargement)
Téléchargements en attente	en attente d'une place libre, ou du bouton Démarrer
Téléchargements terminés	téléchargements terminés dans l'historique de MeTube
Téléchargements en erreur	téléchargements échoués dans l'historique de MeTube
Progression du téléchargement en cours	en pourcentage, 0 quand rien ne se télécharge
Vitesse de téléchargement	en Mo/s, tous téléchargements confondus
Téléchargement en cours	son titre, en texte (« Aucun téléchargement » au repos)
Dernier téléchargement terminé	son titre, en texte

Les téléchargements terminés et en erreur sont ceux que MeTube garde dans son historique : quand vous les effacez dans MeTube, les chiffres baissent.

Tableau de bord

Le widget Téléchargements MeTube affiche trois tuiles (en cours, en attente, en erreur), la file (titre, progression et vitesse, ou ce qu'il attend), et les derniers téléchargements terminés ou en erreur (titre, fichier ou erreur, taille). Deux boutons :

• Ajouter une vidéo : un formulaire avec le lien et la qualité ; la vidéo est ajoutée à MeTube et démarre aussitôt.
• Démarrer : affiché seulement quand des téléchargements ajoutés sans démarrage automatique attendent le bouton Start de MeTube ; il les lance tous.

Ajoutez-le depuis l'éditeur du tableau de bord ; il n'a aucun réglage et fonctionne avant même l'ajout de l'appareil.

Scènes

Déclencheurs

• Téléchargement MeTube terminé : un téléchargement vient de se terminer, quel que soit celui qui l'a ajouté (la page web de MeTube, son extension de navigateur, Gladys). Informations transmises aux actions : le titre, le lien de la vidéo, le nom du fichier et la taille en Mo.
• Téléchargement MeTube en erreur : un téléchargement a échoué (lien non pris en charge, vidéo indisponible ou privée, erreur de yt-dlp). Informations : le titre, le lien et le message d'erreur.

Chaque téléchargement est annoncé une seule fois, même après un redémarrage de l'intégration. Ce que MeTube avait déjà dans son historique quand son adresse a été saisie n'est pas annoncé ; ce qui s'est terminé pendant que l'intégration était arrêtée est annoncé à son redémarrage. Le même lien téléchargé à nouveau est annoncé à nouveau.

Actions

• Ajouter une vidéo à MeTube : ajoute une vidéo ou une playlist à la file de MeTube, lancée aussitôt. Champs : le Lien (une variable d'une étape précédente convient aussi) et la Qualité : meilleure vidéo, 1080p, 720p, 480p, ou audio seul (MP3). Quand MeTube refuse le lien, l'action échoue avec son message.

Idées de scènes

• Quand un téléchargement MeTube se termine, envoyez-vous un message : « {title} est prêt ({size_mb} Mo) ».
• Quand un téléchargement échoue, envoyez-vous le message d'erreur, pour vérifier le lien ou mettre à jour yt-dlp.
• Chaque dimanche à 8 h, ajoutez le lien d'une émission ou d'un podcast hebdomadaire du domaine public en audio seul, pour l'écouter plus tard.

Dépannage

• « MeTube ne répond pas » : vérifiez l'adresse et le port (8081), et que Gladys peut joindre le serveur (même réseau, pare-feu).
• « Aucun MeTube à cette adresse » : un autre service répond sur ce port, ou MeTube tourne avec un URL_PREFIX absent de l'adresse.
• « Identifiant ou mot de passe refusé ou manquant » : un proxy inverse demande un mot de passe ; saisissez son identifiant et son mot de passe.
• « L'adresse redirige » : un proxy inverse renvoie vers une page de connexion ou vers HTTPS ; saisissez l'adresse directe de MeTube sur votre réseau.
• « MeTube a refusé le lien » : yt-dlp ne prend pas en charge le site, ou la vidéo est indisponible ; le message de MeTube dit pourquoi.
• Plus de détails : réglez le LOG_LEVEL de l'intégration sur debug et ouvrez ses logs.

Limites

• Un téléchargement est vu à la lecture suivante : dans l'intervalle de rafraîchissement.
• Un téléchargement que MeTube efface tout seul de son historique (CLEAR_COMPLETED_AFTER) avant la lecture suivante n'est pas annoncé.
• Au plus 10 événements de chaque sorte par lecture : au-delà (une rafale de téléchargements), ils sont comptés, pas annoncés.
• L'intégration ne supprime ni téléchargement ni fichier, n'annule pas un téléchargement et ne gère pas les abonnements de MeTube. Pour suivre automatiquement des chaînes et des playlists YouTube, voir l'intégration Pinchflat.
• Un proxy inverse avec une page de connexion (OAuth, Authelia…) n'est pas pris en charge : seulement une authentification basique (identifiant et mot de passe).
• Sans lien avec MeTube, yt-dlp ni aucun site de vidéos.

Paramètres de configuration

Voici les paramètres demandés par MeTube dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Serveur MeTube	section	Non	Adresse de l'interface web de MeTube. L'intégration lit sa file de téléchargements et y ajoute les liens envoyés depuis Gladys.
Adresse	string	Non	Adresse IP ou nom du serveur, avec le port de l'interface web (8081 par défaut) et l'URL_PREFIX si MeTube en a un.
Identifiant	string	Non	Seulement si un proxy inverse devant MeTube demande un mot de passe (MeTube lui-même n'en a pas).
Mot de passe	secret	Non	Mot de passe du proxy inverse, avec l'identifiant ci-dessus.
Intervalle de rafraîchissement	select	Non	Fréquence de lecture de la file de MeTube : progression, téléchargements terminés et en erreur.
Langue des noms de fonctionnalités	select	Non	Noms donnés aux fonctionnalités à l'ajout de l'appareil, et textes envoyés par l'intégration.

Comment installer MeTube dans Gladys

1. Dans Gladys, ouvrez Intégrations : MeTube apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-metube:1.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-metube.

MeTube nécessite Gladys >=5.2.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes

MeTube est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.

• Parcourir toutes les intégrations, natives et communautaires
• Créer et publier votre propre intégration externe
• Code source sur GitHub — source de cette documentation

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂