Intégration domotique Roon zones (unofficial), gratuite et open source
Connecteur non officiel : sorties Roon, lecture, volume, en cours, groupes, en réseau local.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.3.0
- ★ 0
Connecteur non officiel, sans lien avec Roon Labs. Il parle à votre Roon Core (Roon Server, Nucleus, ROCK, ou l'application Roon qui fait office de Core) en réseau local, par l'API officielle des extensions Roon : sans compte, sans cloud.
Écrite d'après la documentation de l'API Roon : elle n'a jamais été testée avec un vrai Roon Core. Les retours sont bienvenus (issues GitHub de
LM1LC3N7/gladys-roon).
Nécessite Gladys 5.3.0 ou plus récent (widget Musique).
Ce que vous obtenez
Un appareil Gladys par sortie Roon (une pièce, une enceinte, un DAC), avec :
- la lecture : lecture, pause, arrêt (widget Musique), précédent, suivant ;
- le morceau en cours : titre, artiste, album, pochette, durée et position ;
- l'aléatoire et la répétition (non, tout, un) ;
- le volume (0-100 % de la plage de la sortie) et la sourdine, quand Roon peut régler le volume de la sortie (pas pour un volume fixe ni pour des commandes +/- seulement) ;
- le nom de la zone où joue la sortie (par ex. « Salon + Cuisine » une fois regroupées).
Deux actions de scène : regrouper deux sorties (la zone garde la file d'attente de la première) et sortir une sortie de son groupe.
Mise en place
- Saisissez l'adresse du Roon Core (donnez-lui une adresse fixe dans votre box), ou cliquez sur Trouver le Roon Core : Gladys interroge le réseau local, et quand un seul Core répond et qu'aucune adresse n'est saisie, son adresse est enregistrée. Le port est 9330 pour Roon 2 (9100 pour les versions plus anciennes).
- Dans Roon, ouvrez Paramètres > Extensions et cliquez sur Activer à côté de Gladys (community) (éditeur LM1LC3N7, une intégration de la communauté, pas de l'équipe Gladys Assistant). En attendant, le statut indique l'attente d'autorisation.
- Ouvrez l'onglet Découverte et ajoutez les sorties voulues.
L'autorisation donnée par le Core est gardée dans le dossier /data de
l'intégration (jamais dans les journaux, jamais affichée). Oublier
l'autorisation Roon la supprime : il faut alors réactiver l'extension dans
Roon.
Plafond de volume
Plafond de volume (%), 50 par défaut : le volume le plus fort que Gladys peut régler, en pourcentage de la plage de chaque sortie (100 : pas de plafond). Un volume plus fort demandé par une scène ou le tableau de bord est ramené au plafond, arrondi vers le bas au pas de la sortie, et jamais au-dessus des limites réglées dans Roon. Couper la sourdine ramène d'abord le volume sous le plafond s'il est au-dessus (et est refusé quand le volume de la sortie est inconnu, tant qu'un plafond s'applique). Le volume changé dans Roon lui-même n'est pas modifié.
Les commandes et leurs réponses
Une commande réussit quand le Core l'a acceptée et que l'état renvoyé par Roon la montre (lecture, pause, arrêt, volume, sourdine, aléatoire, répétition, regroupement). Le déplacement dans le morceau, précédent et suivant réussissent quand le Core les accepte. Une commande dont l'état est déjà là (lecture sur une zone qui joue) réussit tout de suite ; un volume que le Core rogne (une limite réglée dans Roon) répond « pas encore vue appliquée » alors qu'il est réglé. Sinon la réponse dit ce qui s'est passé : « rien envoyé », « envoyée, sans réponse (non confirmée) », « acceptée, pas encore vue appliquée (non confirmée) » ou « refusée par le Roon Core ».
La pause, l'arrêt, la sourdine et une baisse de volume ne sont pas retenus par le plafond. Ils ne sont refusés que si rien ne peut les recevoir :
- le Roon Core n'est pas connecté (ou pas encore autorisé) ;
- la sortie n'est pas dans Roon en ce moment (éteinte, renommée ou retirée) ;
- la valeur est invalide ;
- pour la sourdine et le volume : la sortie n'a pas de volume que Gladys peut régler ;
- plus de 256 requêtes attendent déjà le Core (un Core qui ne répond plus ; les autres commandes sont retenues dès 64).
Quand deux sorties ou plus portent le nom de l'appareil, la pause, l'arrêt, la sourdine et une baisse de volume partent vers chacune d'elles (le volume seulement vers celles qu'il baisse) ; la lecture, la remise du son, une hausse de volume et les autres commandes sont refusées (quelle pièce serait-ce ?). Une zone qui ne peut pas faire pause (une radio en direct) est arrêtée à la place. Une remise du son qui attend son réglage de volume n'est pas envoyée si une autre commande pour la même sortie a été cliquée entre-temps (une sourdine cliquée après elle n'est jamais doublée).
Bon à savoir
- Identité : une sortie est reconnue à son nom dans Roon, comme le fait
Home Assistant (Roon peut changer ses identifiants internes). Renommer une
sortie dans Roon donne un nouvel appareil dans Gladys et laisse l'ancien
« injoignable » : les scènes qui l'utilisent ne marchent plus, sans erreur.
Noms permutés (deux sorties qui échangent leurs noms dans Roon) : ils se
voient aux identifiants de sortie vus en dernier pour chaque nom (gardés
dans
/data) ; le volume ne part jamais dans l'autre pièce. Jusqu'à une nouvelle Découverte (qui prend les nouveaux noms), l'appareil ne publie rien (son badge indique « injoignable »), la pause, l'arrêt, la sourdine et une baisse de volume vont à la pièce pour laquelle il a été créé, et les autres commandes sont refusées. Deux sorties de même nom sont laissées hors de Découverte et ne publient rien. - Réseau : l'API des extensions Roon passe en
ws://simple sur le réseau local : le jeton d'autorisation et les commandes y circulent en clair, comme pour toute extension Roon. Le jeton est envoyé à ce qui répond à l'adresse saisie avec l'identifiant du Core qui l'a donné. - Les états arrivent en direct du Core (abonnement), rien n'est interrogé à intervalle. Après une perte du Core, rien n'est publié avant son retour ; le badge des appareils indique « injoignable » en attendant. La connexion est retentée après 5 s, puis 10 s, jusqu'à toutes les 2 minutes.
- La pochette est demandée au Core (400 px, 300 Ko au plus) quand Gladys l'affiche.
- Pas encore de listes de lecture, de bibliothèque ni de radios à parcourir (voir le TODO du dépôt).
Paramètres de configuration
Voici les paramètres demandés par Roon zones (unofficial) dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Roon dans Gladys | section | Non | Connecteur non officiel, sans lien avec Roon Labs. Il parle à votre Roon Core en réseau local par l'API officielle des extensions Roon (sans compte, sans cloud) : un appareil Gladys par sortie Roon, avec lecture, pause, arrêt, précédent, suivant, volume, sourdine, aléatoire, répétition, le morceau en cours et sa pochette pour le widget Musique, et le regroupement par des actions de scène. Saisissez l'adresse du Core (ou cliquez sur « Trouver le Roon Core »), puis dans Roon ouvrez Paramètres > Extensions et cliquez sur Activer à côté de « Gladys (community) ». Ouvrez ensuite Découverte pour ajouter les sorties. |
| Adresse du Roon Core | string | Non | Adresse IP (ou nom d'hôte) de l'ordinateur ou de l'appareil qui fait tourner le Roon Core (Roon Server, Nucleus, ROCK…). Donnez-lui une adresse fixe dans votre box. « Trouver le Roon Core » la remplit quand un seul Core répond. |
| Port du Roon Core | number | Non | Le port de l'API des extensions : 9330 pour Roon 2, 9100 pour les versions plus anciennes. |
| Plafond de volume (%) | number | Non | Le volume le plus fort que Gladys peut régler, en pourcentage de la plage de chaque sortie, de 1 à 100 (100 : pas de plafond). Un volume plus fort demandé par une scène ou le tableau de bord est ramené à ce plafond ; couper la sourdine ramène d'abord le volume sous le plafond. Le volume réglé dans Roon lui-même n'est pas modifié, et une baisse de volume, la pause, l'arrêt et la sourdine ne sont jamais retenus par le plafond. |
Comment installer Roon zones (unofficial) dans Gladys
- Dans Gladys, ouvrez Intégrations : Roon zones (unofficial) 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/lm1lc3n7/gladys-roon:0.1.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/LM1LC3N7/gladys-roon.
Roon zones (unofficial) 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
Roon zones (unofficial) 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 LM1LC3N7, 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