Intégration domotique Pinchflat, gratuite et open source
Pinchflat dans Gladys : nouvelles vidéos YouTube téléchargées, file d'attente, erreurs.
Publiée par guim31
- Appareils
- Version 1.0.0
- Nécessite Gladys >=5.1.0
- ★ 0
Retrouvez votre serveur Pinchflat (le téléchargeur auto-hébergé de chaînes et de playlists YouTube, basé sur yt-dlp) dans Gladys, sur votre réseau local : les vidéos téléchargées aujourd'hui, la file d'attente, les téléchargements en erreur, les dernières vidéos sur un tableau de bord, et des scènes qui réagissent quand une nouvelle vidéo arrive ou quand un téléchargement échoue.
L'intégration a été testée avec un vrai Pinchflat 2025.9.26 (l'image Docker officielle, téléchargeant une vraie vidéo), pas encore dans une vraie installation de Gladys : vos retours sont les bienvenus sur le forum Gladys ou dans les issues.
Ce qu'il faut
- Gladys Assistant 5.1.0 ou plus récent.
- Un serveur Pinchflat, joignable depuis Gladys (même réseau), sur le port
de son interface web (
8945par défaut). - Si l'interface demande un mot de passe (
BASIC_AUTH_USERNAMEetBASIC_AUTH_PASSWORDde Pinchflat), cet identifiant et ce mot de passe.
Installation
- Installez l'intégration depuis le catalogue de Gladys.
- Dans Configuration, saisissez l'Adresse de Pinchflat (par exemple
192.168.1.2:8945; sans port,8945est utilisé) et, si l'interface est protégée, l'Identifiant et le Mot de passe. - Enregistrez, puis cliquez sur Tester la connexion : le message sous le bouton donne la version de Pinchflat, les sources, les vidéos en attente et les erreurs.
- 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 1 à 10 minutes (2 minutes par défaut).
- 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 de la phrase de l'action de scène.
Pinchflat n'a pas d'API : l'intégration lit les pages de son interface web (la liste des sources, et la page d'une source), exactement comme un navigateur. Elle n'envoie jamais de formulaire et ne modifie jamais rien dans Pinchflat.
L'appareil
Un appareil, Pinchflat suivi de l'adresse du serveur :
| Fonctionnalité | Ce qu'elle donne |
|---|---|
| En ligne | 1 quand Pinchflat répond, 0 sinon |
| Téléchargées aujourd'hui | vidéos téléchargées depuis minuit (heure locale de Gladys) |
| Vidéos en attente | vidéos à télécharger, toutes sources confondues |
| Vidéos en erreur | vidéos en attente dont le dernier téléchargement a échoué |
| Sources | chaînes et playlists suivies |
| Vidéos téléchargées | vidéos sur le disque, toutes sources confondues |
| Dernière vidéo téléchargée | son titre et sa source, en texte |
Les chiffres bougent à chaque lecture. Vidéos en erreur compte les erreurs affichées dans la première page des vidéos en attente de chaque source (ses 10 mises en ligne les plus récentes).
Tableau de bord
Le widget Vidéos Pinchflat affiche trois tuiles (téléchargées aujourd'hui, en attente, en erreur) et la liste des dernières vidéos téléchargées : titre, source et date. 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
- Vidéo Pinchflat téléchargée : une nouvelle vidéo d'une source vient d'être téléchargée. Filtre : Source (le nom de la chaîne ou de la playlist, exactement comme Pinchflat l'affiche ; vide : n'importe laquelle). Informations transmises aux actions : la source, le titre de la vidéo, sa date de mise en ligne sur YouTube, la page de la vidéo dans Pinchflat et le nombre de vidéos téléchargées aujourd'hui.
- Téléchargement Pinchflat en erreur : le téléchargement d'une vidéo en attente a échoué (vidéo indisponible, réservée aux membres, bloquée, erreur de yt-dlp). Même filtre. Informations : la source, le titre, le message d'erreur et la page de la vidéo.
Chaque vidéo est annoncée une seule fois, même après un redémarrage de l'intégration. Ce que Pinchflat avait déjà au démarrage de l'intégration (ou à l'ajout d'une source) n'est pas annoncé.
Actions
- Lire les dernières vidéos Pinchflat : lit Pinchflat maintenant et donne une phrase pour un message ou une annonce vocale, du type « Pinchflat : 2 vidéos téléchargées aujourd'hui ; dernières : « … » (…), « … » (…). 4 en attente, 1 en erreur. », avec les chiffres à part (téléchargées aujourd'hui, en attente, en erreur, titre et source de la dernière vidéo). Option : le nombre de vidéos citées dans la phrase (3 par défaut).
Idées de scènes
- Quand une vidéo de votre chaîne préférée est téléchargée, envoyez-vous un message : « Nouveau sur le serveur multimédia : {titre} ({source}) ».
- À 19 h, lisez les dernières vidéos Pinchflat et annoncez la phrase sur l'enceinte du salon.
- Quand un téléchargement échoue, envoyez le message d'erreur, pour mettre à jour les cookies de yt-dlp ou vérifier la vidéo.
Dépannage
- « Pinchflat ne répond pas » : vérifiez l'adresse et le port (
8945), et que Gladys peut joindre le serveur (même réseau, pare-feu). - « Identifiant ou mot de passe refusé ou manquant » : l'interface est
protégée ; saisissez les
BASIC_AUTH_USERNAMEetBASIC_AUTH_PASSWORDde Pinchflat. - « L'adresse redirige » : un proxy inverse renvoie vers une page de connexion ou vers HTTPS ; saisissez l'adresse directe de Pinchflat sur votre réseau.
- « Aucun Pinchflat à cette adresse » : un autre service répond sur ce port.
- Pas d'événement pour une vidéo : Pinchflat range les vidéos téléchargées par date de mise en ligne ; une vieille vidéo téléchargée tard (le rattrapage d'une nouvelle source) est comptée dans « Téléchargées aujourd'hui », sans événement de scène.
- Plus de détails : réglez le
LOG_LEVELde l'intégration surdebuget ouvrez ses logs.
Limites
- Lecture seule : l'intégration ne peut ni ajouter une source, ni lancer ou relancer un téléchargement (Pinchflat n'a pas d'API pour cela).
- Un téléchargement en erreur est vu à la lecture suivante de sa source : dans les 15 minutes. Seules les 10 vidéos en attente les plus récentes de chaque source sont examinées.
- 10 pages de sources au plus sont lues par rafraîchissement. Au-delà de 10 sources, Pinchflat n'en liste que 10 sur sa page des sources : les autres sont lues à tour de rôle (10 par rafraîchissement), leurs nouvelles peuvent donc attendre quelques rafraîchissements.
- 10 événements de chaque sorte au plus par rafraîchissement : au-delà (une rafale de téléchargements), les vidéos sont comptées, pas annoncées. Une vidéo supprimée pendant qu'une autre se télécharge, entre deux rafraîchissements, peut masquer ce téléchargement.
- L'intégration lit les pages web de Pinchflat 2025.9.26 : une future version qui les changerait pourrait demander une mise à jour de l'intégration.
- Sans lien avec Pinchflat, YouTube ou Google.
Paramètres de configuration
Voici les paramètres demandés par Pinchflat dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Serveur Pinchflat | section | Non | Adresse de l'interface web de Pinchflat. L'intégration lit seulement ses pages : elle ne modifie jamais rien dans Pinchflat. |
| Adresse | string | Non | Adresse IP ou nom du serveur, avec le port de l'interface web (8945 par défaut). |
| Identifiant | string | Non | Seulement si l'interface demande un mot de passe (BASIC_AUTH_USERNAME de Pinchflat). |
| Mot de passe | secret | Non | BASIC_AUTH_PASSWORD de Pinchflat, avec l'identifiant ci-dessus. |
| Intervalle de rafraîchissement | select | Non | Fréquence de lecture de Pinchflat : nouvelles vidéos, file d'attente, erreurs. |
| Langue des noms de fonctionnalités | select | Non | Noms donnés aux fonctionnalités à l'ajout de l'appareil, et phrase de l'action de scène. |
Comment installer Pinchflat dans Gladys
- Dans Gladys, ouvrez Intégrations : Pinchflat apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/guim31/gladys-pinchflat: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). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-pinchflat.
Pinchflat nécessite Gladys >=5.1.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
Pinchflat 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