Intégration domotique Lyrion Music Server, gratuite et open source

Pilotez les lecteurs Squeezebox et squeezelite de Lyrion (LMS) : musique, volume, favoris, annonces.
Pilotez depuis Gladys les lecteurs de votre Lyrion Music Server (ex-Logitech Media Server, LMS) : Squeezebox Touch, Radio, Boom, Duet, piCorePlayer, squeezelite et tout lecteur compatible. Gladys suit ce que joue chaque lecteur, le pilote, joue vos favoris Lyrion, met toute la maison en pause et diffuse des annonces qui rendent la musique là où elle en était.
Testée avec Lyrion Music Server 9.1 et des lecteurs squeezelite, pas avec une Squeezebox physique : vos retours sont les bienvenus. Cette intégration n'est affiliée ni au projet Lyrion ni à Logitech.
Prérequis
- Gladys Assistant 5.3 ou plus récent (la version 1.0 de l'intégration fonctionne avec Gladys 5.1).
- Un Lyrion Music Server joignable depuis Gladys sur le réseau local : port web 9000 et, pour des mises à jour immédiates, port CLI 9090 (ouverts par défaut). Logitech Media Server 8 a la même API et devrait fonctionner aussi.
- Rien à installer sur les lecteurs.
Configuration
- Dans Intégrations, ouvrez Lyrion Music Server et saisissez l'adresse du serveur
(adresse IP ou nom d'hôte, par exemple
192.168.1.20). Changez le port web s'il ne vaut pas 9000. - Si la protection par mot de passe est active dans Lyrion (Réglages → Avancé → Sécurité), saisissez le nom d'utilisateur et le mot de passe.
- Port CLI : Lyrion y signale chaque changement (9090 par défaut), Gladys voit donc aussitôt un
nouveau morceau ou un changement de volume.
0le désactive : Gladys lit alors les lecteurs toutes les 5 secondes. - Langue des noms de fonctionnalités : le français par défaut. Elle sert aussi aux messages d'erreur des actions de scène.
- Ouvrez l'onglet Découverte : chaque lecteur du serveur y figure. Cliquez sur Ajouter à Gladys.
Appareils
Un appareil par lecteur, identifié par son identifiant de lecteur Lyrion (l'adresse MAC d'une Squeezebox ou de squeezelite) : renommer un lecteur ou changer son adresse IP garde le même appareil.
| Fonctionnalité | Ce qu'elle fait |
|---|---|
| Marche | Allume ou éteint le lecteur (le bouton marche de Lyrion). |
| État de lecture | 1 en lecture, 0 en pause, 2 arrêté ou éteint. Écrire 1, 0 ou 2 lit, met en pause ou arrête. |
| Lecture, Pause | Lit ou reprend, met en pause. |
| Stop | Arrête la lecture. |
| Précédent, Suivant | Morceau précédent ou suivant de la file. |
| Volume | De 0 à 100. |
| Sourdine | Coupe (1) ou rétablit (0) le son ; le volume est gardé. |
| Titre, Artiste, Album | Ce qui joue ; pour une radio, le morceau qu'elle annonce (la station en album), sinon la station en titre. Vides quand la file est vide. |
| Pochette | La pochette du morceau, que Lyrion réduit lui-même. |
| Durée, Position | En secondes ; écrire la position avance ou recule dans le morceau. Une radio a une durée de 0. |
| Aléatoire, Répétition | La lecture aléatoire ; la répétition : aucune, toute la file ou le morceau. |
| Annonce | Cible de l'action de scène Parler sur une enceinte de Gladys : parle, puis la musique reprend. |
Toutes, sauf Marche et Stop, appartiennent à la catégorie Musique de Gladys : la boîte Musique du tableau de bord les affiche et les pilote (section suivante). Le widget Lecteurs Lyrion montre en plus tous les lecteurs d'un coup et les groupes.
Lecteur Musique de Gladys 5.3
Depuis Gladys 5.3, la boîte Musique du tableau de bord est un vrai lecteur, et chaque lecteur Lyrion la remplit entièrement :
- la pochette, le titre, l'artiste et l'album, une barre de progression qu'on fait glisser pour avancer, lecture et pause, précédent, suivant, lecture aléatoire, répétition, le volume et la sourdine ;
- la file d'attente (bouton liste) : la file du lecteur dans l'ordre de lecture, le morceau en cours en évidence ; un appui en lance un autre ;
- la recherche et la navigation (bouton loupe) : la recherche porte sur la bibliothèque de Lyrion (artistes, albums, morceaux, listes de lecture) et sur les noms de vos favoris (vos radios y sont) ; la navigation commence par Favoris, Listes de lecture, Artistes et Albums. Un appui lance l'élément à la place de la file ; le geste secondaire l'ajoute après le morceau en cours ou en fin de file. Un dossier s'ouvre, il ne se lit pas. Un lecteur éteint s'allume.
L'action de scène Lancer une musique sur une enceinte de Gladys choisit un album, un artiste, une liste de lecture, un morceau ou un favori dans le même panneau, et le lance quand la scène s'exécute. Elle retient l'élément par son adresse dans Lyrion (le titre de l'album et son artiste, le fichier d'un morceau) : elle continue de fonctionner après une réanalyse complète de la bibliothèque.
Un appareil ajouté avant la version 1.1.0 garde ses fonctionnalités, sans les nouvelles : ouvrez l'onglet Découverte de l'intégration et cliquez sur Mettre à jour sur le lecteur (Gladys le propose parce que les fonctionnalités ont changé). Les nouvelles fonctionnalités s'ajoutent ; les anciennes gardent leurs scènes et leurs tableaux de bord. Trois changent : Titre et Artiste deviennent des textes de musique (vides quand rien n'est chargé, au lieu d'un tiret), Sourdine prend une valeur (1 coupe, 0 rétablit) au lieu de basculer à chaque appui, et État de lecture vaut 2 au lieu de 0 quand le lecteur est arrêté ou éteint. Les textes vides et l'état 2 valent dès la version 1.1.0 ; la sourdine bascule à chaque appui jusqu'à la mise à jour.
Widget du tableau de bord
Lecteurs Lyrion a un réglage facultatif, un lecteur :
- Vide : tous les lecteurs du serveur en liste, avec ce qu'ils jouent et leur état, et un bouton Tout en pause quand quelque chose joue.
- Un lecteur : la pochette (quand Lyrion en a une), le morceau, l'artiste et l'album, l'état, le volume, le groupe avec lequel il joue, et quatre boutons : lecture/pause, suivant, volume − et volume +. Un lecteur éteint propose Allumer.
Déclencheurs de scène
| Déclencheur | Quand | Filtres | Variables |
|---|---|---|---|
| Lecture démarrée | Un lecteur commence ou reprend la lecture. | Lecteur | Nom du lecteur, titre, artiste, album |
| Lecture arrêtée | Un lecteur cesse de jouer. | Lecteur, raison (mis en pause, arrêté, éteint) | Les mêmes, plus la raison (clé) |
| Morceau changé | Un lecteur passe à un nouveau morceau, ou une radio annonce un nouveau titre. | Lecteur | Nom du lecteur, titre, artiste, album |
Les déclencheurs reflètent ce que font vraiment les lecteurs, quelle que soit l'origine de l'ordre : une scène qui relance la musique sur « Lecture arrêtée » tournerait en boucle. Rien ne se déclenche pour ce qui jouait déjà au démarrage de l'intégration, ni pendant une annonce.
Actions de scène
| Action | Champs | Résultat |
|---|---|---|
| Jouer un favori Lyrion | Lecteur, favori (nom ou position : FIP, 1) | Allume le lecteur et le joue. |
| Régler le volume | Lecteur (vide : tous les lecteurs), volume | |
| Mettre tous les lecteurs en pause | — | Sortie : le nombre de lecteurs mis en pause. |
| Diffuser une annonce | Lecteur, adresse audio (http/https), volume facultatif | La joue, puis rend la musique. |
| Rejoindre un groupe de lecteurs | Lecteur, lecteur à rejoindre | Les deux jouent ensemble (synchro Lyrion). |
| Quitter le groupe | Lecteur | Le lecteur joue de nouveau seul. |
Un favori est trouvé par son nom (sans tenir compte des majuscules ni des accents), sinon par sa position parmi les favoris jouables du premier niveau de Lyrion (les dossiers ne comptent pas). Une annonce est insérée après le morceau en cours, jouée, puis retirée : le lecteur retrouve son morceau, sa position, son volume, son état, son mode de répétition et sa marche.
Exemples de scènes
- Radio du matin : à 7 h 30 en semaine, Jouer un favori Lyrion
FIPsur le lecteur de la cuisine, puis Régler le volume à 25. - Sonnette : quand on sonne, Diffuser une annonce avec l'adresse d'un MP3 de carillon sur le lecteur de l'entrée (une action par lecteur), au volume 60.
- Album du dimanche : le dimanche à 10 h, Lancer une musique sur une enceinte avec un album choisi dans la bibliothèque Lyrion, sur le lecteur du salon.
- Départ de la maison : quand la dernière personne part, Mettre tous les lecteurs en pause.
- Soirée : Rejoindre un groupe pour le salon et la cuisine, et Quitter le groupe à minuit.
Dépannage
- « Le serveur Lyrion ne répond pas » : vérifiez l'adresse et le port web (ouvrez
http://<adresse>:9000dans un navigateur depuis le même réseau). - « Lyrion a refusé le nom d'utilisateur ou le mot de passe » : les mêmes identifiants que l'interface web de Lyrion.
- Les changements mettent 5 secondes : le port CLI est fermé ou désactivé ; Gladys lit alors les lecteurs toutes les 5 secondes. Vérifiez le port 9090, ou le plugin « CLI » de Lyrion.
- Un lecteur manque : il doit être connecté à ce serveur (il figure dans l'interface web de Lyrion), puis relancez une recherche dans l'onglet Découverte.
- La boîte Musique n'a ni pochette ni barre de progression : le lecteur a été ajouté avant la version 1.1.0 ; cliquez sur Mettre à jour dans l'onglet Découverte.
- « Lyrion ne peut pas lire cet élément » : l'élément n'existe plus dans Lyrion (album renommé, fichier déplacé) ; choisissez-le de nouveau dans la scène.
- Journaux : dans la page de l'intégration ;
LOG_LEVEL=debugmontre chaque lecture.
Limites
- Un seul serveur Lyrion par intégration ; pas de découverte automatique (Lyrion ne répond qu'aux requêtes en broadcast, que le bac à sable ne transmet pas) : saisissez son adresse.
- Dans la boîte « appareils d'une pièce », Gladys 5.3 montre l'état de lecture, le volume, la sourdine, l'aléatoire, la répétition et les textes ; les boutons ponctuels (lecture, pause, suivant…) n'y ont pas de ligne : utilisez la boîte Musique ou le widget Lecteurs Lyrion.
- Une annonce sur un groupe joue sur tout le groupe ; en lecture aléatoire, la position rendue peut différer. Un flux sans fin est coupé au bout de 10 minutes.
- L'action Jouer un favori Lyrion ne voit que le premier niveau des favoris ; le panneau de la boîte Musique ouvre leurs dossiers. Les applications de Lyrion (radios en ligne, services de streaming) ne se parcourent pas depuis Gladys : ajoutez-en les éléments aux favoris.
- Réseau local uniquement : l'intégration parle au serveur, jamais à un service cloud.
Paramètres de configuration
Voici les paramètres demandés par Lyrion Music Server dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Connecter votre serveur Lyrion | section | Non | Saisissez l'adresse de l'ordinateur où tourne Lyrion Music Server (ex-Logitech Media Server). Tous les lecteurs qu'il connaît (Squeezebox, piCorePlayer, squeezelite…) apparaissent alors dans l'onglet Découverte. |
| Adresse du serveur | string | Oui | Adresse IP ou nom d'hôte du serveur Lyrion. |
| Port web | number | Non | Port de l'interface web de Lyrion (9000 par défaut). |
| Nom d'utilisateur | string | Non | Seulement si la protection par mot de passe est active dans Lyrion (Réglages, Avancé, Sécurité). |
| Mot de passe | secret | Non | |
| Port CLI | number | Non | Lyrion y signale chaque changement (9090 par défaut) : mises à jour immédiates. 0 le désactive : les lecteurs sont alors lus toutes les 5 secondes. |
| Langue des noms de fonctionnalités | select | Non | Sert aussi aux messages d'erreur des actions de scène. |
Comment installer Lyrion Music Server dans Gladys
- Dans Gladys, ouvrez Intégrations : Lyrion Music Server 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-lyrion:1.1.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-lyrion.
Lyrion Music Server 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
Lyrion Music Server 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