Intégration domotique Denon / Marantz AVR, gratuite et open source

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

• Publiée par LM1LC3N7
• Appareils
• Version 1.0.25
• Nécessite Gladys >=5.1.0
• ★ 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 besoin d'internet (seules la détection optionnelle des coupures pub des radios, et les titres de quelques stations comme OUI FM, passent par internet : voir « Coupures pub des radios »). 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. Uniquement la zone principale (ou la zone choisie dans la Configuration, voir « Zone » ci-dessous) : allumer l'ampli depuis Gladys ne peut plus le réveiller sur la Zone 2, et l'éteindre ne coupe plus une Zone 2 en cours d'écoute.
• 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 — et ça ne concerne que cette échelle basée sur le Telnet, pas la bascule HEOS ci-dessous. Sur un appareil équipé HEOS, si le contrôle Telnet classique n'est pas joignable du tout (voir « Support HEOS » ci-dessous — c'est le cas d'une enceinte HEOS autonome, pas d'un vrai ampli-tuner), Volume/Volume +/Volume - basculent automatiquement sur les commandes HEOS.
• Muet — marche/arrêt, contrôlable. Même bascule vers HEOS que Volume ci-dessus quand le Telnet n'est pas joignable.
• 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'arrive pas jusqu'ici : Gladys ne le transmet pas à ce type d'intégration (une limitation du cœur de Gladys). À la place, réglez Volume des annonces dans la Configuration (0 = volume actuel), et laissez Rétablir l'ampli après une annonce activé : une fois l'annonce terminée, l'ampli retrouve son volume, son entrée et sa veille d'avant (le volume n'est pas touché si quelqu'un l'a changé pendant l'annonce). Ce que HEOS jouait avant l'annonce (une radio, une playlist) ne reprend pas tout seul. C'est aussi une des fonctionnalités 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 — aux côtés de Volume, Muet et Lecture/Pause/Suivant/Précédent (qui ont tous un équivalent HEOS réel, voir « Support HEOS » ci-dessous). Alimentation, Source et Mode sonore nécessitent encore le service Telnet « AVR Control » que ces enceintes n'ont pas — cette intégration n'est donc pas un vrai support des enceintes HEOS, juste les fonctionnalités qui ont déjà un équivalent HEOS. 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.

Widgets du tableau de bord

Depuis Gladys 5.1, cette intégration ajoute ses propres cartes au tableau de bord : modifiez un tableau de bord, ajoutez une carte et cherchez « Denon / Marantz AVR ». Chaque carte a un réglage Ampli pour choisir l'appareil (laissé vide : le premier ampli ajouté). Les cartes affichent et déclenchent ; le curseur de volume et le menu déroulant des entrées restent ceux de la carte « Appareils » de Gladys.

• En cours de lecture — la pochette (ou le logo de la station), le titre, l'artiste ou la station, l'album, l'entrée et le mode son, le volume en direct, avec Précédent, Lecture/Pause, Suivant et Sourdine. C'est ce que la carte « Musique » de Gladys n'affiche pas : ni titre, ni pochette, ni volume pour un ampli. La pochette n'apparaît que si elle pèse moins de 300 Ko (limite de Gladys) et que le conteneur de l'intégration peut la télécharger (souvent sur Internet).
• Raccourcis — quatre boutons en un appui, chacun choisi parmi les entrées (avec vos noms de « Renommer/masquer des sources »), les Quick Select 1 à 5 (Smart Select chez Marantz : entrée, volume et mode son mémorisés dans l'ampli) et les favoris HEOS 1 à 8. Le raccourci actif est coché. Un libellé personnalisé est possible pour chaque bouton.
• Ampli — alimentation, entrée, mode son et sourdine d'un coup d'œil, le volume en direct, et les boutons Allumer/Veille, Vol −, Vol + et Sourdine.
• Télécommande — quatre touches au choix (Haut, Bas, Gauche, Droite, OK, Retour, Menu, Info, Vol −, Vol +, Sourdine, Allumer, Veille ; les quatre flèches par défaut). Posez-en plusieurs côte à côte pour un pavé complet (par exemple une carte « flèches » et une carte « OK / Retour / Menu / Info »).
• Radio — le tuner FM/AM : fréquence, présélection, bande et mode d'accord, avec quatre boutons au choix (Fréq −/+, Présélection −/+, AM/FM, Auto/Manuel, Entrée Tuner). L'ampli n'accepte ces commandes que sur l'entrée Tuner : un appui bascule d'abord dessus si besoin. La bascule AM/FM n'est documentée par Denon que pour les modèles nord-américains. Réglez son paramètre Afficher sur Coupures pub des radios pour voir à la place ce qui a été appris des pubs de la radio web (voir « Coupures pub des radios » plus bas).

Scènes

Depuis Gladys 5.1, l'éditeur de scènes propose les actions et déclencheurs de cette intégration (cherchez « Ampli : ») :

• Ampli : rappeler un Quick Select — Quick Select 1 à 5 (Smart Select chez Marantz).
• Ampli : jouer un favori HEOS — la n-ième entrée des favoris de l'application HEOS (une radio, une playlist…), sur la zone configurée, allumée et basculée sur HEOS si besoin.
• Ampli : régler l'ampli — alimentation, entrée, mode son et volume en une seule action ; un champ laissé vide n'est pas modifié. Idéal pour une scène « Film » ou « Musique ».
• Ampli : lire l'état de l'ampli — renvoie l'alimentation, le volume, l'entrée (code et nom), le mode son, le Quick Select, la lecture, le titre et l'artiste, pour les actions suivantes de la scène — par exemple un « Continuer seulement si » sur l'entrée.
• Déclencheur Ampli : l'entrée a changé — depuis Gladys, la télécommande ou l'application, filtrable sur l'ampli et sur la nouvelle entrée (par exemple : passage sur l'entrée TV → baisser les lumières). L'entrée précédente est disponible en variable.
• Déclencheur Ampli : le morceau a changé — un nouveau titre sur HEOS ou l'entrée réseau, avec titre, artiste, album et entrée en variables.

L'action générique « Contrôler un appareil » fonctionne toujours pour Source, Mode sonore et Index de source. Si elle n'affiche strictement rien pour cet ampli, essayez d'abord un rafraîchissement forcé / de vider le cache du navigateur (cause confirmée une fois : un bundle front mis en cache), puis relancez un scan Découverte et cliquez sur Mettre à jour sur l'appareil.

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.

Volume, Volume +/- et Muet fonctionnent dans l'autre sens : les commandes Telnet classiques restent prioritaires tant que cette connexion est active (c'est le contrôle du volume de la zone principale, confirmé correct sur un vrai ampli), et ne basculent vers HEOS que si le Telnet n'est pas joignable du tout — en pratique, une enceinte HEOS autonome sans aucun service « AVR Control ». Si vos contrôles Volume/Muet ont cessé de répondre après cette mise à jour sur un vrai ampli-tuner, cela signifierait qu'autre chose ne va pas avec la connexion Telnet (vérifiez les logs de l'intégration) — ce n'est pas cette bascule qui se déclenche.

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é.

Coupures pub des radios

Désactivé par défaut. Pour l'utiliser, activez Détecter les coupures pub des radios dans la configuration, puis relancez une Découverte et cliquez sur Mettre à jour sur l'appareil pour obtenir son interrupteur Radio ad break.

Quand une radio joue via HEOS (TuneIn, favori, URL de flux), l'intégration repère ses coupures pub et allume l'interrupteur Radio ad break de l'appareil pendant celles-ci. Par défaut, elle baisse aussi le volume de 20 crans, sans descendre sous 20, puis le remet quand la musique reprend. Si vous avez touché au volume entre-temps, c'est votre réglage qui est gardé. Le tout se règle dans la section « Coupures pub des radios » de la configuration. Pour agir vous-même dans une scène (changer de station, couper le son…), désactivez la baisse automatique et déclenchez votre scène sur Radio ad break. Vous pouvez aussi l'actionner vous-même : l'allumer veut dire « c'est la pub » (le volume baisse tout de suite, et l'intégration apprend), l'éteindre termine la coupure et remet le volume.

Comment ça marche. Aucune radio n'annonce « c'est la pub » dans son flux. En revanche, beaucoup indiquent le titre en cours, et parfois sa durée. Quand une chanson se termine sans qu'une autre suive, la station passe soit de la pub, soit l'animateur qui parle. Les deux se distinguent par l'heure. Pour chaque station, l'intégration apprend les minutes de l'heure où tombent ses coupures (longues de 4 à 8 minutes en général ; de 3 min 20 s à 15 min sont acceptées), par exemple :09–:14 et :34–:47 sur OUI FM :

• dans une de ces fenêtres, une fin de chanson suivie de ~45 s sans musique est traitée comme une coupure. Ce délai laisse passer l'animateur avant le jingle pub ;
• en dehors, le volume ne baisse jamais sur un simple silence musical : une chronique, les infos ou une interview ne sont pas des pubs. Seul le jingle pub de la station, une fois appris, peut y ouvrir une coupure ;
• la coupure se termine quand le titre suivant démarre, avec 10 minutes maximum par sécurité.

Les fenêtres dépendent du jour et de l'heure : la semaine, le samedi et le dimanche ont chacun les leurs, et une heure où la station ne passe habituellement pas de pub (le soir, la nuit) n'en a aucune. L'apprentissage est continu : tant que la station est suivie, son historique de diffusion est relu toutes les heures, et le tout est calculé sur les 2 dernières semaines (chaque jour de la semaine vu deux fois). Un changement de grille est donc pris en compte en quelques jours. Les heures sans pub ne s'apprennent que sur les stations qui publient leur historique ; ailleurs, toutes les heures gardent les fenêtres.

Le jingle pub. Chaque station ouvre ses coupures par le même jingle (sur OUI FM, « restez avec nous pendant la pub »). Pendant l'écoute, l'intégration décode le flux de la station (ffmpeg) et compare le son des coupures entre elles. Le son qui revient dans la plupart d'entre elles, même couvert par la voix de l'animateur, devient le jingle de la station. Il reste d'abord en observation, puis devient actif après 2 détections suivies d'une vraie coupure. Dès lors, le volume baisse au jingle, au lieu d'attendre 45 s, et l'animateur n'est plus coupé. Si une coupure arrive sans jingle, la règle des fenêtres prend le relais. Il faut compter quelques heures d'écoute (3 longues coupures), ou allumer 3 fois Radio ad break juste après le jingle. Un jingle qui se met à donner de fausses alertes est oublié et réappris.

D'où viennent les titres :

• Métadonnées HEOS : pour toute station qui en fournit (ex. Radio Paradise via TuneIn). La durée des titres est retrouvée sur Deezer.
• Flux dédié : pour les stations dont le flux n'en contient aucune. C'est le cas d'OUI FM, suivie via le flux temps réel de son propre site (titre, artiste et durée exacte). Le titre s'affiche alors aussi dans « Now playing », au lieu du simple nom de la station. Les fenêtres pub sont apprises dès la première écoute à partir des ~3 jours d'historique publiés par le site (de même pour Voltage, Alouette, Hit West et les autres stations de la plateforme Les Indés Radios).
• Rien du tout (ex. certaines stations TuneIn) : allumez Radio ad break quand la pub commence, éteignez-le quand elle se termine. Après quelques coupures signalées, l'intégration connaît l'horaire de la station et baisse le volume toute seule à ces moments-là. C'est moins précis qu'avec des titres, faute de savoir quand la musique s'arrête vraiment. Allumez-le juste après le jingle de début, éteignez-le juste après celui de fin : l'intégration apprend les deux (ils peuvent être différents). Faute de titres pour les vérifier, un jingle repéré n'est validé que s'il tombe dans une fenêtre pub de la station, ou si vous allumez l'interrupteur juste après ; pour celui de fin, s'il tombe pendant une coupure.

Sur une station avec titres, allumer Radio ad break sert aussi à affiner le délai : faites-le au moment du jingle pub, et l'intégration apprend le jingle lui-même et combien de temps l'animateur parle avant les pubs, heure par heure. Exemple : le matin sur OUI FM, il n'y a pas d'animateur et la pub suit directement la chanson. Deux fois à ces heures-là suffisent pour que la baisse y soit immédiate.

Limite connue : la fin de coupure n'est connue qu'au démarrage du titre suivant. Si l'animateur reprend la parole après les pubs, il reste à volume réduit jusqu'à la chanson.

Allumer la radio pendant la pub :

• avec flux de la station (OUI FM…) : repéré en quelques secondes — le flux donne le dernier titre et son début, l'intégration sait donc qu'il s'est terminé sans titre suivant, dans une fenêtre de pub ;
• sans aucun titre : dans une des fenêtres de pub de la station, la coupure démarre tout de suite, pour ce qu'il reste de sa durée habituelle (comptée depuis l'ouverture de la fenêtre), sauf s'il reste moins de 30 s. Pareil après une pause reprise pendant la coupure ; une fois arrêtée à la main, cette fenêtre-là n'est plus reprise ;
• avec titres HEOS : pas repéré — le début du premier titre vu est inconnu, donc sa fin aussi, et baisser le volume au hasard le ferait aussi sur de la musique. L'intégration se recale au titre suivant ; allumez Radio ad break entre-temps si besoin.

Votre volume revient toujours. Une coupure ne dure jamais plus de 10 minutes. Si l'intégration s'arrête ou redémarre pendant une coupure (mise à jour, changement de configuration), le volume est remis en partant. Si la connexion à l'ampli tombe, il est remis dès que HEOS répond à nouveau (abandon au bout d'une heure, ou si le volume a été changé entre-temps). Une annonce « Parler sur une enceinte » pendant une coupure la termine d'abord : l'annonce passe à votre volume normal, qui revient ensuite.

Ce qui a été appris. Ajoutez au tableau de bord un widget Radio réglé sur Afficher : Coupures pub des radios. Il montre la station en cours (sinon la dernière écoutée) :

• si une pub est en cours, ou l'heure de la prochaine fenêtre de pub (Prochaine pub 14:34–14:47) ;
• les pubs entendues sur les 14 derniers jours, leur durée type, celles du jour ;
• chaque jingle : actif (avec ses détections confirmées), en observation, ou pas encore appris ;
• d'où viennent les changements de titre, combien de temps l'animateur parle en général avant la pub, le volume baissé en ce moment ;
• une carte par type de jour (semaine, samedi, dimanche) : les heures avec pub et leurs fenêtres (6h–21h · :09–:14, :34–:47) ; ouvrez-la pour le détail heure par heure, avec les pubs entendues à chaque heure ;
• les dernières pubs (date, heure, durée, comment elles ont été repérées) et le détail de chaque jingle (où il se place, quand il a été appris) ;
• un bouton C'est la pub ! / Fin de la pub, équivalent à l'interrupteur Radio ad break.

Le planning habituel en graphique. L'appareil a aussi une fonctionnalité Radio ad window : 1 tant que la station (en cours, sinon la dernière écoutée) est dans une de ses fenêtres de pub habituelles, 0 en dehors — le planning appris, à la minute près. Ajoutez le widget Graphique de Gladys, type Binaire, avec Radio ad window et Radio ad break (les vraies coupures) : sur 24 heures ou une semaine, les bandes montrent quand la pub passe d'habitude et quand elle est vraiment passée. Le graphique ne dessine que le passé ; la prochaine fenêtre est dans le widget Radio. Comme l'interrupteur, il faut avoir mis à jour l'appareil depuis la Découverte, et la détection activée.

Le bouton Bilan des coupures pub de l'écran Configuration résume de la même façon, en texte, toutes les stations apprises. Les heures sont affichées, et apprises, dans le Fuseau horaire de la configuration (Europe/Paris par défaut) : Gladys fait tourner les intégrations en UTC.

Ce que ça consomme, uniquement pendant qu'une radio joue avec la détection activée :

• des requêtes internet vers TuneIn (une fois par station), Deezer (durée des titres) et, pour les stations comme OUI FM, leur site (flux des titres en direct, historique relu chaque heure) ;
• avec Reconnaître les jingles pub : le flux radio est téléchargé une seconde fois et décodé (environ 30 à 90 Mo par heure selon la qualité de la station), et après chaque coupure quelques secondes de calcul, hors du fil principal de l'intégration. Désactivez-le pour économiser la bande passante : les coupures ne sont alors repérées que par la règle des fenêtres.

Désactivée, la détection ne consomme rien ; seul le titre des stations dont le flux n'en contient aucun (OUI FM…) reste lu sur leur site pendant l'écoute. Ce qui est appris est gardé dans le dossier de données de l'intégration (/data/ad-breaks.json, /data/ad-jingles/).

Prérequis

• Gladys 5.1.0 ou plus récent (widgets et actions/déclencheurs de scène propres à l'intégration).
• 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. Si l'ampli change ensuite d'adresse IP (DHCP), relancez un scan Découverte et cliquez sur Mettre à jour sur l'appareil : la connexion bascule aussitôt sur la nouvelle adresse, sans redémarrage.
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.
6. Zone (onglet Configuration) : la zone d'un ampli multizone que Gladys pilote — Zone principale par défaut, ce qui convient dans la quasi-totalité des cas. Alimentation, volume (et Volume +/-), muet, source (et Index de source, Sélectionner l'entrée) visent uniquement cette zone, et seul l'état de cette zone est affiché sur le tableau de bord. Une annonce « Parler sur une enceinte » allume d'abord cette zone et la bascule sur l'entrée réseau/HEOS (NET), pour qu'elle y soit toujours jouée — jamais sur la zone que HEOS a utilisée en dernier. Choisissez Zone 2/Zone 3 seulement pour piloter cette zone à la place (le mode sonore et les touches du menu de configuration agissent toujours sur la zone principale, la seule à avoir un menu à l'écran). Le changement s'applique immédiatement, inutile de rajouter l'appareil.
7. Annonces (onglet Configuration) : Volume des annonces (0 = garder le volume actuel) et Rétablir l'ampli après une annonce pour l'action « Parler sur une enceinte » — voir « Diffuser une notification » plus haut.
8. Coupures pub des radios (onglet Configuration) : désactivé par défaut, voir « Coupures pub des radios » plus haut — puis Mettre à jour l'appareil depuis la Découverte pour obtenir son interrupteur Radio ad break. Fuseau horaire : celui des heures de pub (nom IANA, Europe/Paris par défaut). Bilan des coupures pub : ce qui a été appris de chaque station.

Dépannage

• Le badge de l'appareil (liste des appareils) dit l'état de chaque ampli : local = joignable ; injoignable = ni le contrôle Telnet ni HEOS ne répondent (ampli débranché, veille réseau désactivée, mauvaise IP) ; un point orange signale un fonctionnement dégradé, avec la raison au survol — HEOS ne connaît aucun lecteur à l'IP de l'ampli (« Parler sur une enceinte » ne fonctionnera pas), ou seul HEOS répond (une enceinte HEOS autonome, ou un ampli dont le port 23 est fermé).

• 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 ».
Zone	select	Non	La zone de l'ampli pilotée par Gladys : commandes d'alimentation, de volume, de sourdine et de source, ainsi que les annonces « Parler sur une enceinte » (la zone est d'abord allumée et basculée sur l'entrée HEOS/Réseau). Zone principale par défaut ; à changer seulement pour piloter la Zone 2/3 à la place.
Annonces	section	Non	Pour l'action de scène « Parler sur une enceinte » (modèles HEOS). Gladys ne transmet pas aux intégrations externes le volume choisi dans la scène : il se règle ici.
Volume des annonces (%)	number	Non	Volume réglé avant chaque annonce, de 1 à 100. 0 garde le volume actuel.
Rétablir l'ampli après une annonce	boolean	Non	Une fois l'annonce terminée, remet le volume, l'entrée et la veille que l'ampli avait avant.
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.
Coupures pub des radios	section	Non	Pendant qu'une radio joue via HEOS, l'intégration apprend à quels moments cette station diffuse ses coupures pub (à partir des changements de titre : métadonnées de la station, ou flux dédié pour les radios comme OUI FM qui n'en mettent aucune dans leur flux) et allume l'interrupteur « Radio ad break » de l'appareil pendant celles-ci. Vous pouvez aussi l'actionner vous-même : allumé quand la pub commence (elle apprend de vos signalements), éteint quand elle se termine.
Détecter les coupures pub des radios	boolean	Non	Désactivé par défaut. Activé, l'intégration contacte internet pendant qu'une radio joue : TuneIn, Deezer (durée des titres), le site de la station. Mettez à jour l'appareil depuis la Découverte pour obtenir son interrupteur « Radio ad break ». Désactivé, seul le titre des stations sans métadonnées dans leur flux (OUI FM…) est lu sur leur site.
Baisser le volume pendant les pubs	boolean	Non	Désactivez pour n'avoir que l'interrupteur « Radio ad break », et agir dessus dans votre propre scène.
Reconnaître les jingles pub	boolean	Non	Apprend le jingle pub de chaque station pour baisser le volume pile dessus. Télécharge le flux radio une seconde fois pendant l'écoute (environ 30 à 90 Mo par heure).
Baisse de volume pendant les pubs	number	Non	De combien de crans (échelle 0-100) baisser. Le volume revient quand la musique reprend, sauf si vous l'avez modifié à la main entre-temps.
Volume minimum pendant les pubs	number	Non	Le volume n'est jamais baissé sous ce niveau (échelle 0-100), pour que les pubs restent audibles.
Fuseau horaire	string	Non	Des heures de pub apprises et affichées, au format IANA (Europe/Paris, Europe/Brussels, America/Montreal…). Sinon, les intégrations tournent en UTC.

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.25), 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 >=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

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 🙂