Intégration domotique YouTube Music Player, gratuite et open source
Pilotez l'application YouTube Music depuis Gladys : lecture, volume, file d'attente et recherche.
Publiée par prohand
- Appareils
- Version 0.0.1
- Nécessite Gladys >=5.3.0
- ★ 0
Cette intégration permet à Gladys de piloter l'application de bureau YouTube Music (th-ch/youtube-music) installée sur un ordinateur de votre réseau : un PC, un Mac, ou un Raspberry Pi branché sur vos enceintes. La musique sort de cet ordinateur ; Gladys affiche ce qui est joué et le pilote.
Ce que vous obtenez dans Gladys :
- un appareil lecteur de musique par ordinateur : lecture, pause, précédent, suivant, volume, muet, aléatoire, répétition, position, titre, artiste, album et pochette ;
- la carte musique du tableau de bord : lecture en cours, recherche dans YouTube Music, file d'attente, et un dossier « Recently played » (écoutés récemment) ;
- un widget « YouTube Music » pour le tableau de bord : ce qui est joué, le volume, lecture/pause, précédent, suivant, et un bouton pour lancer un titre par son nom ;
- des déclencheurs de scène : un nouveau titre démarre, la lecture démarre ou se met en pause, un lecteur se connecte ou se déconnecte ;
- des actions de scène : jouer un titre par son nom (maintenant, ensuite, ou en fin de file), aimer ou ne pas aimer le titre en cours.
Gladys 5.3 ou plus récent est nécessaire.
1. Préparer l'application YouTube Music
- Installez l'application YouTube Music depuis sa page de versions (Windows, macOS, Linux). Gardez-la à jour : les versions récentes envoient les changements en direct à Gladys.
- Ouvrez l'application et connectez-vous à votre compte YouTube Music si vous voulez votre bibliothèque.
- Dans le menu, ouvrez Plugins, puis activez API Server.
- Dans les options d'API Server, gardez :
- Hostname :
0.0.0.0(l'application répond alors sur le réseau, pas seulement sur l'ordinateur) ; - Port :
26538; - Authorization strategy : « Authorize at first request » (recommandé). « No authorization » marche aussi, mais tout appareil de votre réseau peut alors piloter l'application.
- Hostname :
- Si l'ordinateur a un pare-feu, autorisez les connexions TCP entrantes sur le port
26538. - Donnez une adresse IP fixe à l'ordinateur dans votre box (réservation DHCP) : Gladys trouve l'application par son adresse.
2. Configurer l'intégration dans Gladys
-
Ouvrez la configuration de l'intégration.
-
Dans Lecteurs, listez les ordinateurs, séparés par des virgules, sous la forme
Nom=adresse[:port]:Salon=192.168.1.20, Bureau=192.168.1.30:26538Le port vaut
26538si vous ne l'indiquez pas. Le nom est celui de l'appareil dans Gladys. -
Enregistrez. Sur chaque ordinateur, YouTube Music affiche une fenêtre qui demande d'autoriser
gladys-…: cliquez sur Autoriser (Allow). Une seule fois : l'accès est gardé après un redémarrage. -
Cliquez sur Tester les lecteurs : chaque lecteur doit répondre « OK ».
-
Ouvrez Découverte et créez les appareils.
Si vous avez cliqué sur Refuser (Deny) par erreur, utilisez le bouton Autoriser un lecteur, puis cliquez sur Autoriser sur l'ordinateur.
3. L'utiliser
- Tableau de bord : ajoutez la boîte « Musique » et choisissez le lecteur, ou ajoutez le widget YouTube Music (boîte « Widgets d'intégration »). Le widget montre le premier lecteur si vous n'en choisissez pas.
- Recherche : dans la carte musique, cherchez un titre ou un artiste et choisissez un morceau. Il est joué maintenant, après le titre en cours, ou en fin de file.
- Scènes :
- le déclencheur Un nouveau titre démarre donne
title,artist,albumetvideo_idaux actions suivantes ; - le déclencheur La lecture démarre ou se met en pause peut être limité à « Lecture » ou « Pause » — par exemple, baisser les lumières quand la musique démarre le soir ;
- le déclencheur Un lecteur se connecte ou se déconnecte — par exemple, vous prévenir quand le PC du salon s'éteint ;
- l'action Jouer un titre par son nom — par exemple un réveil en musique : « Jouer
radio jazzsur Chambre à 7 h ». Elle renvoiefound,titleetartist; - l'action Aimer ou ne pas aimer le titre en cours, pour noter un titre depuis un bouton mural.
- L'action habituelle « Contrôler un appareil » marche aussi sur les fonctions du lecteur (volume, pause…).
- le déclencheur Un nouveau titre démarre donne
Bon à savoir
- L'application ne peut mettre en file que des titres seuls : la recherche montre des titres et des vidéos, pas des albums ni des playlists.
- « Stop » met en pause : l'application n'a pas d'arrêt.
- Recently played liste les titres vus par l'intégration depuis son démarrage (50 par lecteur).
- L'adresse et le port identifient un lecteur. Si vous les changez, Gladys voit un nouvel appareil : supprimez l'ancien.
- Avec une ancienne version de l'application (sans liaison en direct), Gladys lit l'état toutes les 5 secondes et l'appareil affiche un point orange. Mettez l'application à jour pour retrouver le direct.
- L'intégration ne parle qu'à l'application, sur votre réseau (transport local). Pas de compte cloud, pas de clé d'API.
Dépannage
| Ce que vous voyez | Que faire |
|---|---|
| « Pas de réponse sur 192.168.1.20:26538 » | L'application est-elle ouverte ? API Server est-il activé, avec le hostname 0.0.0.0 ? Le port 26538 est-il ouvert ? |
| « Accès refusé dans l'application » | Utilisez Autoriser un lecteur, puis cliquez sur Autoriser sur l'ordinateur. |
| « Vérifiez la liste des lecteurs » | Une entrée de Lecteurs est illisible : écrivez-la Nom=192.168.1.20 ou Nom=hôte:port. |
| L'appareil reste « injoignable » | L'ordinateur est en veille ou l'application est fermée. Gladys se reconnecte seul à son retour. |
| La recherche ne donne rien | La recherche utilise votre session YouTube Music dans l'application : vérifiez qu'elle est connectée. |
Pour plus de détails dans les logs, activez Logs détaillés dans la configuration.
Paramètres de configuration
Voici les paramètres demandés par YouTube Music Player dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Pour commencer | section | Non | Cette intégration pilote l'application de bureau YouTube Music (th-ch/youtube-music) installée sur un ordinateur de votre réseau. Dans l'application, ouvrez Plugins, activez « API Server » et gardez son port (26538). Listez ensuite les ordinateurs ci-dessous. La première fois, l'application demande d'autoriser Gladys : cliquez sur Autoriser sur l'ordinateur. |
| Lecteurs | string | Oui | Une entrée par ordinateur avec YouTube Music, séparées par des virgules : Nom=adresse[:port]. Le port vaut 26538 s'il est omis. |
| Logs détaillés | boolean | Non | Journalise chaque échange avec les applications (niveau debug), pour diagnostiquer un problème. |
Comment installer YouTube Music Player dans Gladys
- Dans Gladys, ouvrez Intégrations : YouTube Music Player 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/prohand/gladys-youtubemusicplayer:0.0.1), 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/prohand/gladys-youtubemusicplayer.
YouTube Music Player nécessite Gladys >=5.3.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
YouTube Music Player 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 prohand, 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