Intégration Denon / Marantz AVR pour Gladys Assistant

Contrôlez un ampli Denon ou Marantz : alimentation, volume, muet, source — découverte automatique.

• Publiée par LM1LC3N7
• Appareils
• Version 1.0.18
• Nécessite Gladys >=4.86.1
• ★ 1

Voir sur GitHubToutes les intégrations externes

Contrôlez un ampli-tuner (AVR) Denon ou Marantz depuis Gladys : alimentation, volume, muet et source. Compatible avec le protocole « AVR Control » partagé par (presque) toute la gamme des amplis réseau Denon/Marantz — pas limité à un modèle précis.

Vue d'ensemble

L'intégration parle directement à votre ampli sur le réseau local (Telnet, port TCP 23) — pas de compte cloud, pas de dépendance internet. L'ampli pousse lui-même chaque changement d'état (alimentation, volume, muet, source) dès qu'il se produit, que ce soit depuis Gladys, la télécommande physique ou l'application Denon/HEOS, si bien que le tableau de bord reste synchronisé en temps réel.

Voici ce qui apparaît par ampli :

• Alimentation — marche/arrêt, contrôlable.
• Volume — 0-100 %, contrôlable (converti depuis l'échelle interne de l'ampli, -80 dB à +18 dB). Confirmé sur du matériel réel : un pourcentage précis (25 % sur l'échelle par défaut) ne peut jamais rester tel quel — le régler bascule immédiatement à 26 %. C'est une vraie limite matérielle (l'ampli n'a que 99 crans de volume pour les 101 valeurs de pourcentage possibles), pas un bug que cette intégration peut corriger.
• Muet — marche/arrêt, contrôlable.
• Source — un menu déroulant des codes d'entrée de l'ampli (ex. TUNER, BD, NET), directement sur le tableau de bord. L'action Sélectionner l'entrée décrite ci-dessous fait exactement la même chose et reste disponible en alternative — utile si votre instance Gladys est sur une version plus ancienne qui n'affiche pas encore le menu déroulant. Vous pouvez renommer ou masquer des entrées — voir Configuration ci-dessous.
• Index de source — le même contrôle de source, mais sous forme de nombre plutôt qu'un menu déroulant : 0 correspond à la première entrée actuellement affichée dans le menu Source ci-dessus, 1 à la deuxième, etc. Si vous masquez une entrée (voir Configuration ci-dessous), tout ce qui suit se décale d'un cran — la numérotation correspond toujours à ce qui est réellement visible dans le menu au moment donné. Cette fonctionnalité existe pour les scènes : voir « Automatiser la source/le mode sonore depuis une scène » ci-dessous pour savoir si vous en avez besoin, selon votre version de Gladys.
• Mode sonore — un menu déroulant des modes surround/sonores (ex. MOVIE, STEREO, PURE DIRECT). Moins uniforme d'un ampli à l'autre que les autres contrôles — si un mode que vous utilisez depuis la télécommande n'apparaît pas, il manque probablement à la liste générique fournie par cette intégration.
• Lecture / Pause / Suivant / Précédent — des boutons qui contrôlent la lecture sur une source réseau/USB/streaming (Qobuz, Spotify Connect, TIDAL, radio internet...). Sans effet sur une source qui n'est pas un lecteur (une entrée TV, par exemple). Il faut une carte Musique, pas la liste d'appareils classique : sur votre tableau de bord, ajoutez une carte et choisissez le type Musique, puis cet ampli comme appareil — c'est ce qui affiche réellement les boutons lecture/pause/suivant. Dans la liste d'appareils classique, ils apparaissent juste comme des lignes sans valeur visible, c'est normal à cet endroit. Sur un ampli équipé HEOS, ces boutons passent par HEOS dès que possible, car c'est le seul chemin qui fonctionne réellement pour les sources gérées par HEOS comme Qobuz ou Spotify Connect — voir « Support HEOS » ci-dessous.
• En cours de lecture — une ligne « Artiste - Titre » en lecture seule, renseignée automatiquement pendant la lecture en streaming. Pour une radio internet sans métadonnées de morceau, le champ « Artiste » reprend le nom de la station elle-même (ex. « Oui FM ») — le même nom que celui affiché sur l'écran de l'ampli — plutôt que de rester vide à côté d'une simple description technique du flux comme « 63 kbps aac ».
• Diffuser une notification — alimente l'action de scène native de Gladys « Parler sur une enceinte » : choisissez cet ampli dans le menu déroulant des enceintes de cette action, et il lira votre texte à voix haute. Nécessite HEOS (voir « Support HEOS » ci-dessous) — il n'existe aucun moyen via le Telnet classique de lire une URL audio arbitraire, donc ceci n'apparaît/ne fonctionne qu'une fois qu'un identifiant de lecteur HEOS a été trouvé pour cet ampli. Le curseur de volume de cette action de scène n'a aucun effet ici : Gladys ne le transmet pas à ce type d'intégration (une limitation du cœur de Gladys, pas quelque chose que cette intégration peut contourner) — l'annonce est lue au volume actuel de l'ampli. C'est aussi la seule fonctionnalité de cette page qui fonctionne sur une enceinte HEOS autonome (Denon Home, HEOS 1/3/5/7, Bar...) ajoutée via l'IP manuelle dans la Configuration, et pas seulement sur un vrai ampli-tuner — tout le reste ici (alimentation, volume, source...) nécessite le service Telnet « AVR Control » que ces enceintes n'ont pas, donc cette intégration ne fonctionnera sinon pas du tout avec ce type d'appareil. Déclencher cette action de scène plusieurs fois rapidement remplace ce qui est en train d'être dit au lieu de s'accumuler derrière — la file d'attente est vidée avant chaque annonce, confirmé nécessaire sur du matériel réel (sans ça, une rafale d'annonces se relisait l'une après l'autre au lieu que seule la dernière ne compte).
• Télécommande du menu de configuration — curseur Haut/Bas/Gauche/Droite, Entrée, Retour, Info, Menu et Volume +/- relatif, affichés comme boutons cliquables directement dans la liste d'appareils (pas besoin d'une carte de tableau de bord supplémentaire). Pratique pour naviguer dans le menu de configuration à l'écran de l'ampli depuis Gladys, sans chercher la télécommande physique. Vous ne voulez pas de tous ces boutons sur votre tableau de bord ? Masquez ceux dont vous ne vous servez pas comme n'importe quelle autre fonctionnalité d'appareil — rien à configurer du côté de cette intégration.

Automatiser la source/le mode sonore depuis une scène

Dans une scène, c'est l'action générique « Contrôler un appareil » qui permet de régler Source/Mode sonore/Index de source — il n'existe aucune action de scène pour les boutons propres au manifeste d'une intégration (Sélectionner l'entrée ici), sur aucune version de Gladys.

• Sur Gladys 4.86.1 ou plus récent, « Contrôler un appareil » affiche déjà un vrai menu déroulant avec les libellés pour Source et Mode sonore, exactement comme le tableau de bord : choisissez l'appareil, puis la fonctionnalité, puis la valeur. L'Index de source fonctionne aussi si vous préférez fixer un simple nombre.
• Sur une version plus ancienne de Gladys, ce menu déroulant n'est soit pas proposé, soit n'accepte pas la valeur — utilisez plutôt l'Index de source : c'est un simple nombre, que « Contrôler un appareil » a toujours su régler, et qui correspond à la même entrée que le menu déroulant (position dans la liste Source actuellement visible, 0 = première entrée).
• Si « Contrôler un appareil » n'affiche strictement rien pour cet ampli (ni menu Source/Mode sonore, ni Index de source) : essayez d'abord un rafraîchissement forcé / de vider le cache du navigateur — confirmé une fois comme étant la vraie cause : un bundle front mis en cache affichait un sélecteur totalement vide pour cet appareil alors que d'autres intégrations (MQTT, Zigbee2MQTT) fonctionnaient normalement, corrigé instantanément en vidant le cache, sans aucun changement de configuration. Toujours rien après ça ? L'appareil a probablement été ajouté avant que cette intégration ne propose l'Index de source, combiné à une version de Gladys antérieure à 4.86.1 — ouvrez l'onglet Découverte de l'intégration, lancez un scan, puis cliquez sur Mettre à jour sur l'appareil, comme tout autre changement de structure (voir Configuration ci-dessous).

Support HEOS

Les amplis Denon/Marantz équipés d'un module HEOS (la plupart des modèles réseau récents) font tourner HEOS comme un service séparé, à côté du contrôle Telnet classique utilisé pour tout le reste de cette page. Les sources de streaming comme Qobuz, Spotify Connect, TIDAL ou TuneIn sont en réalité lues via HEOS — les commandes de transport classiques que cette intégration utilisait auparavant n'ont strictement aucun effet dessus.

Depuis cette version, les boutons Lecture/Pause/Suivant/Précédent parlent automatiquement à HEOS quand l'ampli le supporte : rien à configurer, rien à activer. Si HEOS n'est pas joignable (pas de module HEOS, ou son port réseau bloqué), les boutons basculent automatiquement sur les commandes classiques, qui continuent de fonctionner pour les sources Net/USB non-HEOS de l'ampli.

Une fois HEOS confirmé pour votre ampli, il devient aussi la source de l'état de lecture et du titre/artiste « En cours de lecture » — actualisés à la fois quand HEOS pousse un changement et via une vérification en arrière-plan toutes les 30 secondes, pour que le tableau de bord se remette à jour tout seul en moins d'une demi-minute même si une notification est manquée (cela peut arriver si la connexion HEOS se coupe brièvement, un comportement connu de HEOS sur une connexion inactive).

Limites : ceci est implémenté à partir du protocole réseau propre à HEOS (non officiel, mais largement utilisé), recoupé avec la bibliothèque derrière l'intégration HEOS officielle de Home Assistant — non testé par le développeur sur une vraie session de streaming HEOS, car cela nécessite un compte de streaming payant réel. Si les boutons ne font rien chez vous alors que l'ampli est joignable, merci de le signaler (avec les logs mentionnés plus bas) pour que ce soit corrigé.

Prérequis

• Un ampli-tuner Denon ou Marantz avec une connexion réseau (Ethernet/Wi-Fi).
• La veille réseau (parfois appelée veille « ECO ») activée dans le menu de configuration de l'ampli. Sans cela, l'ampli disparaît complètement du réseau une fois éteint et Gladys ne peut plus le joindre (y compris pour le rallumer).
• Gladys et l'ampli sur le même réseau local/VLAN, avec le multicast autorisé entre eux (nécessaire pour la découverte automatique, voir ci-dessous).

Configuration

1. Ouvrez l'onglet Découverte de l'intégration et lancez un scan. Les amplis Denon/Marantz répondent automatiquement (SSDP/UPnP) — aucune IP à saisir, aucun compte. L'ampli devrait apparaître avec son vrai nom et son modèle.
2. Ajoutez l'appareil découvert. Gladys maintient ensuite une connexion persistante avec lui.
3. Si rien n'est trouvé : votre réseau bloque probablement le multicast entre segments (VLAN, plusieurs cartes réseau sur l'hôte Gladys, certains Wi-Fi maillés...). Ouvrez l'onglet Configuration de l'intégration et renseignez manuellement l'adresse IP de l'ampli, enregistrez, puis relancez un scan : il apparaîtra comme entrée de secours. Plusieurs amplis que le scan ne trouve pas (par exemple sur des réseaux différents) ? Séparez leurs adresses par des virgules, ex. 192.168.1.50, 192.168.2.50 — chacune devient sa propre entrée de secours. Une IP fixe ou une réservation DHCP pour chaque ampli est alors recommandée, car l'entrée manuelle ne suit pas automatiquement les changements d'IP.
4. Deux actions sont disponibles depuis l'écran de configuration pour chaque ampli ajouté :
   • Tester la connexion — interroge l'ampli et rapporte son état actuel (alimentation, volume, muet, source avec son index — voir « Index de source » ci-dessus —, mode sonore).
   • Sélectionner l'entrée — choisissez une entrée dans la liste standard des codes source Denon/Marantz et basculez dessus.
5. Renommer ou masquer des sources dans le menu déroulant (onglet Configuration, avancé) : le menu montre des codes génériques comme SAT/CBL ou GAME, pas ce qui est réellement branché. Renseignez des paires CODE=Label séparées par des virgules pour les renommer — ex. SAT/CBL=Chromecast si c'est ce qui est branché sur cette entrée — ou CODE= (rien après le =) pour retirer une entrée que vous n'utilisez jamais, ex. SAT/CBL=Chromecast, GAME=. Une fois enregistré, relancez un scan Découverte et cliquez sur Mettre à jour sur l'appareil — les choix du menu font partie de la structure de l'appareil, ils ne se rafraîchissent pas automatiquement avec la configuration.

Dépannage

• Le scan ne trouve rien : vérifiez que Gladys et l'ampli sont sur le même segment réseau et que le multicast/UPnP n'est pas filtré par votre routeur ou vos switchs, puis utilisez l'IP manuelle de secours (voir ci-dessus).
• Détecté mais les commandes ne s'appliquent pas / pas de retour d'état : vérifiez que le Telnet (port 23) n'est pas désactivé ou bloqué par un pare-feu sur l'interface réseau de l'ampli, et qu'aucun autre contrôleur n'accapare la session Telnet au point d'en bloquer de nouvelles (rare, mais certains modèles limitent le nombre de clients Telnet simultanés).
• Ampli injoignable une fois éteint : activez la veille réseau / veille ECO dans le menu de configuration de l'ampli (voir Prérequis).
• L'intégration journalise tout ce qu'elle fait : consultez les logs de l'intégration depuis l'interface Gladys (ou docker logs sur l'hôte). Notez que Gladys lui-même n'offre aucun moyen de régler LOG_LEVEL=debug sur le conteneur d'une intégration installée (ce n'est ni une des variables d'environnement fixes que Gladys définit, ni un champ de configuration) — ce réglage ne s'applique que si vous lancez cette intégration vous-même en dehors de Gladys (voir « Run it locally » dans le README développeur). Toute ligne de log réellement utile pour le dépannage (une connexion à l'ampli, un identifiant de lecteur HEOS trouvé, un flux « Parler sur une enceinte » accepté ou rejeté...) est volontairement journalisée au niveau info ou plus pour cette raison précise, afin qu'elle s'affiche sans debug ; seul le détail très verbeux ligne par ligne du protocole Telnet est réservé à debug et donc hors de portée depuis une installation Gladys classique.
• Mode sonore, boutons de lecture ou lecture en cours ne fonctionnent pas comme attendu : ces fonctions reposent sur des parties du protocole qui varient plus d'un modèle/firmware à l'autre que alimentation/volume/muet/source. Comparez ce que votre télécommande envoie réellement avec ce que cette intégration attend — le détail ligne par ligne nécessaire pour ça n'existe qu'en debug (voir ci-dessus), donc utilisez directement scripts/debug-telnet.js/ scripts/debug-heos.js contre l'ampli plutôt que les logs du conteneur.
• Les boutons de lecture ne font toujours rien sur Qobuz/Spotify Connect/TIDAL : vérifiez les logs à la recherche d'une ligne mentionnant « HEOS player id ... matched » peu après la connexion de l'ampli — si elle n'y est pas, le service HEOS CLI de cet ampli (port 1255) n'était pas joignable (pare-feu, modèle plus ancien sans HEOS, ou HEOS pas encore prêt) et l'intégration est repassée silencieusement sur les commandes classiques, qui n'atteignent pas les sources gérées par HEOS.
• « Parler sur une enceinte » n'apparaît pas du tout dans la liste des enceintes : l'appareil a probablement été créé avant l'arrivée de cette fonctionnalité — ouvrez l'onglet Découverte de cette intégration, lancez un scan, et cliquez sur Mettre à jour sur l'appareil (voir « Re-publishing a device » dans la section Découverte).
• La scène s'exécute sans erreur, mais rien ne sort de l'ampli Denon : c'est normal côté Gladys même en cas d'échec — une scène journalise une action en échec et se signale comme exécutée quand même, sans jamais remonter d'erreur visible pour cette action précise. Vérifiez, dans l'ordre :
  1. Lancez Tester la connexion depuis l'écran Configuration de cette intégration : sa réponse se termine maintenant par une ligne du type « HEOS : identifiant lecteur 12345 trouvé » ou « HEOS : non connecté »/« aucun identifiant lecteur trouvé ». Tout ce qui n'est pas « identifiant lecteur ... trouvé » signifie que le problème vient de HEOS lui-même — mêmes causes que pour les boutons de lecture ci-dessus (port 1255 bloqué par un pare-feu, modèle plus ancien sans HEOS, ou HEOS pas encore prêt après un redémarrage).
  2. Si HEOS est connecté mais qu'aucun identifiant lecteur n'est trouvé, regardez dans les logs la ligne qui liste les IP vues par HEOS (« HEOS reports: ... ») — un ampli avec plusieurs interfaces réseau (Ethernet + Wi-Fi) peut annoncer à HEOS une adresse différente de celle utilisée par cette intégration, ce qui empêche la correspondance définitivement.
  3. Si un identifiant lecteur est trouvé, regardez dans les logs le résultat du flux lui-même : une ligne indiquant que HEOS a rejeté le flux (avec un code d'erreur/texte venant de l'ampli) signifie que l'URL de synthèse vocale n'était pas lisible du point de vue de l'ampli (injoignable depuis le réseau de l'ampli, format non supporté...). Une ligne indiquant que HEOS l'a acceptée alors que vous n'entendez toujours rien ne devrait plus se produire (confirmé et corrigé sur du matériel réel : une version précédente encodait l'URL du flux, ce que certains amplis acceptent sans broncher — succès annoncé, un « Url Stream » générique apparaît même comme piste en cours — sans jamais réellement la récupérer, donc rien ne joue quels que soient l'entrée, l'alimentation, le volume ou l'état muet ; voir la section « Speak on a speaker » du README développeur pour la cause exacte). Si ça se reproduit avec une installation à jour, merci de le signaler.

Paramètres de configuration

Voici les paramètres demandés par Denon / Marantz AVR dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Pour commencer	section	Non	Les amplis Denon/Marantz sont découverts automatiquement sur le réseau local (SSDP/UPnP) : ouvrez l'onglet Découverte et lancez un scan. Vérifiez que la 'veille réseau' (ou 'ECO') est activée dans le menu de configuration de l'ampli pour qu'il reste joignable une fois éteint. Si votre réseau bloque le multicast (VLAN...), renseignez plutôt l'IP manuelle ci-dessous.
IP/nom d'hôte manuel (secours)	string	Non	Utile seulement si le scan automatique ne trouve pas (tous) vos amplis. Laissez vide sinon. Plusieurs réseaux/amplis : séparez les adresses par des virgules, ex. « 192.168.1.50, 192.168.2.50 ».
Port Telnet (avancé)	number	Non	Tous les modèles Denon/Marantz utilisent le port 23. À modifier seulement pour une configuration non standard.
Base du délai de reconnexion (s)	number	Non	Délai de base avant une tentative de reconnexion Telnet ; il augmente avec les échecs consécutifs, plafonné à 120 s.
Renommer/masquer des sources (avancé)	string	Non	Personnalisez le menu déroulant des sources : liste de paires CODE=Label séparées par des virgules pour renommer une entrée (ex. « SAT/CBL=Chromecast » si c'est en réalité ce qui est branché sur cette entrée), ou CODE= (label vide) pour la masquer entièrement, ex. « SAT/CBL=Chromecast, GAME= ». Les codes sont ceux listés dans l'action Sélectionner l'entrée. Après une modification, relancez un scan Découverte et cliquez sur Mettre à jour sur l'appareil — les choix d'un menu déroulant font partie de sa structure, un simple changement de configuration ne le rafraîchit pas.

Comment installer Denon / Marantz AVR dans Gladys

1. Dans Gladys, ouvrez Intégrations : Denon / Marantz AVR 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/lm1lc3n7/gladys-denon-avr:1.0.18), 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/LM1LC3N7/gladys-denon-avr.

Denon / Marantz AVR nécessite Gladys >=4.86.1. 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

Denon / Marantz AVR 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 externes
• Découvrir les intégrations natives intégrées à Gladys
• 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 🙂