node-red-contrib-tts-ultimate 3.0.7 → 3.2.0

package/ttsultimate/ttsultimate.html

@@ -1,4 +1,14 @@
 <script type="text/html" data-template-name="ttsultimate">
+    <style>
+        .ttsSliderValue {
+            display: inline-block;
+            min-width: 34px;
+            margin-left: 8px;
+            text-align: right;
+            font-weight: bold;
+            vertical-align: middle;
+        }
+    </style>
     <div class="form-row">
         <b>TTS Ultimate configuration</b>&nbsp&nbsp&nbsp&nbsp<span style="color:red"><i class="fa fa-question-circle"></i>&nbsp<a target="_blank" href="https://github.com/Supergiovane/node-red-contrib-tts-ultimate"><u>Help online</u></a></span>
         <br/>
@@ -17,48 +27,60 @@
 <div id="allGUI">
     <div class="form-row">
         <label for="node-input-voice"><i class="icon-tag"></i> Voice</label>
-        <select id="node-input-voice">
+        <select id="node-input-voice" style="width:60%">
             <option value='Joanna'>Joanna (en-US)</option>
         </select>
+        <a id="refreshVoices" class="red-ui-button" title="Refresh voices list" style="margin-left:5px"><i class="fa fa-refresh"></i></a>
     </div>
 
     <div id = "divGoogleTTSAudioConfig">
         <div class="form-row">
             <label for="node-input-speakingrate"><i class="fa fa-volume-up"></i> Rate</label>
-            <input type="text" id="node-input-speakingrate" style="width:60px"> (Between 0.25 and 4.0, default 1)
+            <input type="range" id="node-input-speakingrate" min="0.25" max="4.0" step="0.05" style="width:50%; vertical-align:middle;">
+            <span class="ttsSliderValue" id="val-speakingrate">1</span> <small>(0.25 - 4.0, default 1)</small>
         </div>
         <div class="form-row">
             <label for="node-input-speakingpitch"><i class="fa fa-volume-up"></i> Pitch</label>
-            <input type="text" id="node-input-speakingpitch" style="width:60px"> (Between -20.0 and 20.0,  default 0)
+            <input type="range" id="node-input-speakingpitch" min="-20" max="20" step="0.5" style="width:50%; vertical-align:middle;">
+            <span class="ttsSliderValue" id="val-speakingpitch">0</span> <small>(-20.0 - 20.0, default 0)</small>
         </div>
     </div>
     <div id="divElevenLabsOptions" hidden>
         <div class="form-row">
             <label for="node-input-elevenlabsStability"><i class="fa fa-volume-up"></i> Stability</label>
-            <input type="text" id="node-input-elevenlabsStability" style="width:60px"> (default 0.5)
+            <input type="range" id="node-input-elevenlabsStability" min="0" max="1" step="0.05" style="width:50%; vertical-align:middle;">
+            <span class="ttsSliderValue" id="val-elevenlabsStability">0.5</span> <small>(default 0.5)</small>
         </div>
         <div class="form-row">
             <label for="node-input-elevenlabsSimilarity_boost"><i class="fa fa-volume-up"></i> Similarity boost</label>
-            <input type="text" id="node-input-elevenlabsSimilarity_boost" style="width:60px"> (Default 0.5)
+            <input type="range" id="node-input-elevenlabsSimilarity_boost" min="0" max="1" step="0.05" style="width:50%; vertical-align:middle;">
+            <span class="ttsSliderValue" id="val-elevenlabsSimilarity_boost">0.5</span> <small>(default 0.5)</small>
         </div>
-        <div class="form-row">
+        <div class="form-row" id="divElevenLabsStyle">
           <label for="node-input-elevenlabsStyle"><i class="fa fa-volume-up"></i> Style Exaggeration </label>
-          <input type="text" id="node-input-elevenlabsStyle" style="width:60px"> (Default 0.0)
+          <input type="range" id="node-input-elevenlabsStyle" min="0" max="1" step="0.05" style="width:50%; vertical-align:middle;">
+          <span class="ttsSliderValue" id="val-elevenlabsStyle">0.0</span> <small>(default 0.0)</small>
         </div>
         <div class="form-row">
+          <label for="node-input-elevenlabsSpeed"><i class="fa fa-tachometer"></i> Speed</label>
+          <input type="range" id="node-input-elevenlabsSpeed" min="0.7" max="1.2" step="0.05" style="width:50%; vertical-align:middle;">
+          <span class="ttsSliderValue" id="val-elevenlabsSpeed">1.0</span> <small>(0.7 - 1.2, default 1.0)</small>
+        </div>
+        <div class="form-row" id="divElevenLabsSpeakerBoost">
           <label></label>
           <input type="checkbox" id="node-input-elevenlabsUse_speaker_boost" style="margin-left: 0px; vertical-align: top; width: auto !important;"> <label style="width:auto !important;"> Speaker boost</label>
         </div>
         <div class="form-row">
           <label for="node-input-elevenlabsModel"><i class="fa fa-cubes"></i> Model</label>
-          <select id="node-input-elevenlabsModel" style="width:60%">
-            <option value="">Automatic</option>
+          <select id="node-input-elevenlabsModel" style="width:55%">
+            <option value="">Automatic (recommended)</option>
             <option value="eleven_monolingual_v1">Eleven Monolingual v1</option>
             <option value="eleven_multilingual_v1">Eleven Multilingual v1</option>
             <option value="eleven_multilingual_v2">Eleven Multilingual v2</option>
             <option value="eleven_turbo_v2">Eleven Turbo v2</option>
             <option value="eleven_turbo_v2_5">Eleven Turbo v2.5</option>
           </select>
+          <a id="refreshElevenLabsModels" class="red-ui-button" title="Refresh models list" style="margin-left:5px"><i class="fa fa-refresh"></i></a>
         </div>
         <div class="form-row">
           <label for="node-input-elevenlabsOptimizeLatency"><i class="fa fa-tachometer"></i> Latency preset</label>
@@ -107,9 +129,30 @@
         <label for="node-input-playertype"><i class="fa fa-play"></i> Player</label>
         <select id="node-input-playertype">
             <option value="sonos">Sonos</option>
+            <option value="googlecast">Google Cast (Chromecast / Nest)</option>
+            <option value="dlna">DLNA / UPnP renderer</option>
             <option value="noplayer">No player, only output file name.</option>
         </select>
-    </div>    
+    </div>
+
+    <div id="divCastDlna">
+        <div class="form-row">
+            <label for="node-input-playervolume"><i class="fa fa-volume-up"></i> Volume</label>
+            <input type="text" id="node-input-playervolume" style="width:150px" placeholder="0-100">
+        </div>
+        <div class="form-row" id="playerDiscoverRow">
+            <label for="playerDiscoverList"><i class="fa fa-search"></i> Discover</label>
+            <select id="playerDiscoverList" style="width:250px"><option value="">-- press Discover --</option></select>
+            <a id="playerDiscoverBtn" class="red-ui-button" style="width:auto;"><i class="fa fa-refresh"></i> Discover</a>
+        </div>
+        <div class="form-row">
+            <label for="node-input-playeripaddress"><i class="fa fa-globe"></i> <span id="playeraddresslabel">Device</span></label>
+            <input type="text" id="node-input-playeripaddress" style="width:250px">
+        </div>
+        <div class="form-row">
+            <p id="playeraddresshint" style="margin-left:105px;color:#888;"></p>
+        </div>
+    </div>
 
     <div id="divSonos">
         <div class="form-row">
@@ -128,7 +171,9 @@
             <label for="node-input-sonosipaddress"><i class="fa fa-globe"></i> Main Sonos Player</label>
             <label style="width:200px;" id="node-input-sonosipaddress">Discovering.... wait...</label>
         </div>
-    
+    </div>
+
+    <div id="divAdditionalPlayers">
         <dt><i class="fa fa-code-fork"></i>&nbsp; Additional players</dt>
         <div class="form-row node-input-rule-container-row">
             <ol id="node-input-rule-container"></ol>
@@ -175,6 +220,17 @@
           required: false,
           type: "text"
         },
+        playeripaddress:
+        {
+          value: "",
+          required: false
+        },
+        playervolume:
+        {
+          value: "50",
+          required: false,
+          type: "text"
+        },
         sonoshailing:
         {
           value: "Hailing_Hailing.mp3",
@@ -201,6 +257,7 @@
         elevenlabsStability: { value: "0.5", required: false },
         elevenlabsSimilarity_boost: { value: "0.5", required: false },
         elevenlabsStyle: { value: "0.0", required: false },
+        elevenlabsSpeed: { value: "1.0", required: false },
         elevenlabsUse_speaker_boost: { value: true, required: false },
         elevenlabsModel: { value: "", required: false },
         elevenlabsOptimizeLatency: { value: "", required: false },
@@ -230,6 +287,7 @@
 	        var node = this;
 	        var oNodeServer = RED.nodes.node($("#node-input-config").val()); // Store the config-node
 	        if (node.elevenlabsModel !== undefined) $("#node-input-elevenlabsModel").val(node.elevenlabsModel);
+	        if (node.elevenlabsSpeed !== undefined) $("#node-input-elevenlabsSpeed").val(node.elevenlabsSpeed);
 	        if (node.elevenlabsOptimizeLatency !== undefined) $("#node-input-elevenlabsOptimizeLatency").val(node.elevenlabsOptimizeLatency);
 	        if (node.elevenlabsOutputFormat !== undefined) $("#node-input-elevenlabsOutputFormat").val(node.elevenlabsOutputFormat);
 	        if (node.elevenlabsSeed !== undefined) $("#node-input-elevenlabsSeed").val(node.elevenlabsSeed);
@@ -264,6 +322,7 @@
 	          try {
 	            oNodeServer = RED.nodes.node($(this).val());
 	            getVoices();
+	            getElevenLabsModels();
 	            updateTtsOptionsVisibility();
 	          } catch (error) {
 	          }
@@ -277,18 +336,91 @@
           node.playertype = "sonos";
           $("#node-input-playertype").val("sonos");
         }
-        if (node.playertype === "sonos") {
-          $("#divSonos").show();
-        } else {
-          $("#divSonos").hide();
+        var playerDiscovered = false; // discover only once per shown section, unless refreshed manually
+
+        // Discovery endpoint used by the per-row "Additional players" list (Sonos / Cast / DLNA).
+        function currentPlayerDiscoveryUrl() {
+          var pt = $("#node-input-playertype").val();
+          if (pt === "googlecast") return 'ttsultimateDiscoverCast';
+          if (pt === "dlna") return 'ttsultimateDiscoverDLNA';
+          return 'sonosgetAllGroups';
         }
 
-        $("#node-input-playertype").change(function () {
-          if ($("#node-input-playertype").val() === "sonos") {
-            $("#divSonos").show();
-          } else {
-            $("#divSonos").hide();
+        // Discovery for the MAIN player address field (Google Cast IP or DLNA description URL).
+        // All endpoints share the { name, host } shape, so a single code path works.
+        function runPlayerDiscovery() {
+          var pt = $("#node-input-playertype").val();
+          var noun = pt === "googlecast" ? "Cast devices" : "renderers";
+          $("#playerDiscoverList").html('<option value="">Discovering... please wait ~4s</option>');
+          $.getJSON(currentPlayerDiscoveryUrl(), function (data) {
+            $("#playerDiscoverList").empty();
+            if (typeof data === "string" || !data || data.length === 0) {
+              $("#playerDiscoverList").append($("<option></option>").attr("value", "").text("No " + noun + " found - type manually below"));
+              return;
+            }
+            $("#playerDiscoverList").append($("<option></option>").attr("value", "").text("-- select a discovered device --"));
+            data.forEach(function (dev) {
+              $("#playerDiscoverList").append($("<option></option>").attr("value", dev.host).text(dev.name + " (" + dev.host + ")"));
+            });
+          }).fail(function () {
+            $("#playerDiscoverList").html('<option value="">Discovery failed - type manually below</option>');
+          });
+        }
+
+        // Picking a discovered device fills the main address field.
+        $("#playerDiscoverList").change(function () {
+          var v = $(this).val();
+          if (v) $("#node-input-playeripaddress").val(v);
+        });
+        $("#playerDiscoverBtn").click(function (e) {
+          e.preventDefault();
+          runPlayerDiscovery();
+        });
+
+        // Re-render the additional players rows so each row re-discovers using the
+        // current player type (Sonos groups vs Cast devices), preserving entered hosts.
+        function rebuildAdditionalPlayers() {
+          try {
+            var items = $("#node-input-rule-container").editableList('items');
+            var saved = [];
+            items.each(function () {
+              var r = $(this);
+              saved.push({ host: r.find(".rowRulePlayerHost").val(), hostVolumeAdjust: r.find(".rowRulePlayerHostAdjustVolume").val() });
+            });
+            $("#node-input-rule-container").editableList('empty');
+            saved.forEach(function (rule, idx) {
+              $("#node-input-rule-container").editableList('addItem', { r: rule, i: idx });
+            });
+          } catch (e) { }
+        }
+
+        function refreshPlayerSections() {
+          var pt = $("#node-input-playertype").val();
+          $("#divSonos").toggle(pt === "sonos");
+          $("#divCastDlna").toggle(pt === "googlecast" || pt === "dlna");
+          $("#playerDiscoverRow").toggle(pt === "googlecast" || pt === "dlna");
+          // Additional players are supported for grouped Sonos and multi-room Google Cast / DLNA.
+          $("#divAdditionalPlayers").toggle(pt === "sonos" || pt === "googlecast" || pt === "dlna");
+          if (pt === "googlecast") {
+            $("#playeraddresslabel").text("Main Chromecast / Nest IP");
+            $("#playeraddresshint").text("IP address of the main Google Cast device, e.g. 192.168.1.50");
+          } else if (pt === "dlna") {
+            $("#playeraddresslabel").text("Renderer description URL");
+            $("#playeraddresshint").text("UPnP device description XML URL, e.g. http://192.168.1.50:1400/desc.xml");
           }
+          // Auto-discover the first time a discoverable section is shown.
+          if ((pt === "googlecast" || pt === "dlna") && !playerDiscovered) {
+            playerDiscovered = true;
+            runPlayerDiscovery();
+          }
+        }
+        refreshPlayerSections();
+
+        $("#node-input-playertype").change(function () {
+          playerDiscovered = false; // force re-discovery for the newly selected type
+          $("#playerDiscoverList").html('<option value="">-- press Discover --</option>');
+          rebuildAdditionalPlayers();
+          refreshPlayerSections();
         });
         // ###########################
 
@@ -363,8 +495,93 @@
 	        }
 	        updateTtsOptionsVisibility();
 	        getVoices();
+
+	        // Refresh voices list on demand
+	        $("#refreshVoices").click(function (e) {
+	          e.preventDefault();
+	          if (oNodeServer === null || oNodeServer === undefined || !oNodeServer.ttsservice) {
+	            RED.notify("Please select a valid TTS service first.", { type: 'warning', timeout: 3000 });
+	            return;
+	          }
+	          getVoices();
+	        });
 	        // #####################################
 
+        // ElevenLabs: read models and their capabilities from the API, then propose them to the user.
+        // Options not supported by the selected model are automatically disabled.
+        // #####################################
+        function applyElevenLabsModelCapabilities() {
+          var $opt = $("#node-input-elevenlabsModel option:selected");
+          var modelVal = $("#node-input-elevenlabsModel").val();
+          // "Automatic" (empty) or models loaded without capability data => keep everything enabled.
+          var styleSupported = (modelVal === "" || modelVal === null) ? true : ($opt.data("style") !== false);
+          var boostSupported = (modelVal === "" || modelVal === null) ? true : ($opt.data("boost") !== false);
+          toggleElevenLabsRow("#divElevenLabsStyle", "#node-input-elevenlabsStyle", styleSupported);
+          toggleElevenLabsRow("#divElevenLabsSpeakerBoost", "#node-input-elevenlabsUse_speaker_boost", boostSupported);
+        }
+        function toggleElevenLabsRow(rowSelector, inputSelector, supported) {
+          if (supported) {
+            $(rowSelector).css("opacity", "1");
+            $(inputSelector).prop("disabled", false);
+          } else {
+            $(rowSelector).css("opacity", "0.4");
+            $(inputSelector).prop("disabled", true);
+          }
+        }
+
+        function getElevenLabsModels() {
+          if (oNodeServer === null || oNodeServer === undefined || !oNodeServer.ttsservice || oNodeServer.ttsservice.indexOf("elevenlabs") === -1) return;
+          $.getJSON("ttsgetmodels" + encodeURIComponent(oNodeServer.id) + "?ttsservice=" + oNodeServer.ttsservice, new Date().getTime(), (data) => {
+            if (!Array.isArray(data)) return;
+            // Backend signalled an error/missing key: keep the static fallback list and warn the user.
+            if (data.length === 1 && data[0].error) {
+              RED.notify(data[0].name, { type: 'warning', timeout: 6000 });
+              return;
+            }
+            if (data.length === 0) return;
+            var $sel = $("#node-input-elevenlabsModel");
+            $sel.find('option').remove().end();
+            $sel.append($("<option></option>").attr("value", "").text("Automatic (recommended)"));
+            data.forEach(m => {
+              var $o = $("<option></option>").attr("value", m.model_id).text(m.name);
+              $o.attr("data-style", m.can_use_style === true);
+              $o.attr("data-boost", m.can_use_speaker_boost === true);
+              if (m.languages && m.languages.length) $o.attr("title", "Languages: " + m.languages.join(", "));
+              $sel.append($o);
+            });
+            $sel.val(node.elevenlabsModel !== undefined ? node.elevenlabsModel : "");
+            if ($sel.val() === null) $sel.val(""); // Saved model no longer offered by the API
+            applyElevenLabsModelCapabilities();
+          });
+        }
+        getElevenLabsModels();
+
+        $("#node-input-elevenlabsModel").change(applyElevenLabsModelCapabilities);
+
+        // Refresh ElevenLabs models list on demand
+        $("#refreshElevenLabsModels").click(function (e) {
+          e.preventDefault();
+          if (oNodeServer === null || oNodeServer === undefined || !oNodeServer.ttsservice || oNodeServer.ttsservice.indexOf("elevenlabs") === -1) {
+            RED.notify("Please select an ElevenLabs TTS service first.", { type: 'warning', timeout: 3000 });
+            return;
+          }
+          getElevenLabsModels();
+        });
+        // #####################################
+
+        // Voice options sliders: show the current value live next to each slider.
+        // #####################################
+        function setupVoiceOptionSlider(id) {
+          var $input = $("#node-input-" + id);
+          var $out = $("#val-" + id);
+          if ($input.length === 0 || $out.length === 0) return;
+          var update = function () { $out.text($input.val()); };
+          $input.on("input change", update);
+          update();
+        }
+        ["speakingrate", "speakingpitch", "elevenlabsStability", "elevenlabsSimilarity_boost", "elevenlabsStyle", "elevenlabsSpeed"].forEach(setupVoiceOptionSlider);
+        // #####################################
+
         // Refresh the combo
         // #####################################
         node.refreshHailingList = () => {
@@ -504,7 +721,7 @@
           let oAdjustVolume = $('<select/>', { class: "rowRulePlayerHostAdjustVolume", type: "text", style: "width:200px; margin-left: 5px; text-align: left;" }).appendTo(row);
           for (let index = -100; index < 100; index += 5) {
             let sTesto = "";
-            if (index === 0) sTesto = "Same volume as Main Sonos Player";
+            if (index === 0) sTesto = "Same volume as Main Player";
             if (index < 0) sTesto = "Decrease volume by " + Math.abs(index);
             if (index > 0) sTesto = "Increase volume by " + index;
             oAdjustVolume.append($("<option></option>")
@@ -538,8 +755,8 @@
               resizeRule(container);
             });
 
-            $.getJSON('sonosgetAllGroups', (data) => {
-              if (typeof data === "string" && data == "ERRORDISCOVERY") { // 10/04/2020 if error in discovery, fallback to manual IP input
+            $.getJSON(currentPlayerDiscoveryUrl(), (data) => {
+              if ((typeof data === "string" && data == "ERRORDISCOVERY") || !data || data.length === 0) { // 10/04/2020 if error/empty discovery, fallback to manual IP input
                 // Transform the dropdown to a simple input
                 oPlayer.remove();
                 oPlayer = $('<input/>', { class: "rowRulePlayerHost", type: "text", style: "width:200px; margin-left: 5px; text-align: left;" }).appendTo(row);
@@ -609,7 +826,7 @@
 </script>
 
 <script type="text/markdown" data-help-name="ttsultimate">
-<p>This node transforms a text into a speech audio that you can hear natively via SONOS speakers, or save it to a file.</p>
+<p>This node transforms a text into a speech audio that you can hear natively via Sonos speakers, Google Cast devices (Chromecast / Google Nest), generic DLNA/UPnP renderers, or save it to a file.</p>
 
 **General**
 |Property|Description|
@@ -618,12 +835,14 @@
 | Voice | Select your preferred voice. The list depends on the selected TTS engine (Google / ElevenLabs / Voice.ai). Google service without authentication has a limited set of voices. |
 | Hailing | Before the first TTS message of the message queues, the node will play an "hailing" sound. You can select the hailing, upload your own, or totally disable it. |
 | Upload hail | It allows you to upload your own hailing file. |
-| Player | Select the player. If you select not to use a player, the node will output a msg with an array of files, ready to be played by third party nodes. In case you select No player, only output file name, you'll get a message with an additional property filesArray, containing an array of all mp3 files ready to be played with third party nodes. Please see below the OUTPUT MESSAGES FROM THE NODE section. |
+| Player | Select the player: **Sonos**, **Google Cast** (Chromecast / Google Nest), **DLNA / UPnP renderer**, or **No player**. If you select No player, only output file name, the node will output a msg with an additional property filesArray, containing an array of all mp3 files ready to be played by third party nodes. Please see below the OUTPUT MESSAGES FROM THE NODE section. |
 | Volume | Set the preferred TTS volume, from "0" to "100" (can be overridden by passing msg.volume = "40"; to the node). |
-| Unmute | Unmute the main and the addotional players, then restore the previous mute state once finished. (Can be overridden by passing msg.unmute = true; to the node). |
-| Resume | If music was playing prior to TTS messages, the node will try to resume it, but can fail in some cases. Enabla this option to avoid resuming music after TTS message. |
+| Unmute | (Sonos only) Unmute the main and the addotional players, then restore the previous mute state once finished. (Can be overridden by passing msg.unmute = true; to the node). |
+| Resume | (Sonos only) If music was playing prior to TTS messages, the node will try to resume it, but can fail in some cases. Enabla this option to avoid resuming music after TTS message. |
 | Main Sonos Player | Select your Sonos primary player. (It's strongly suggested to set a fixed IP for this player; you can reserve an IP using the DHCP Reservation function of your router/firewall's DHCP Server). It's possibile to group players, so your announcement can be played on all selected players. For this to happen, you need to select your primary coordinator player. All other players will be then controlled by this coordinator. |
-| Additional Players | Here you can add all additional players that will be grouped toghether to the Main Sonos Player coordinator group. You can add a player using the "ADD" button, below the list. For each additional player, you can adjust their volume, based on the Main Sonos Player volume -+100. |
+| Main Chromecast / Nest IP | (Google Cast) IP address of the main Google Cast device (e.g. 192.168.1.50). Press **Discover** to auto-detect the Cast devices on your network and pick one from the list. |
+| Renderer description URL | (DLNA) The full UPnP device description XML URL of the renderer (e.g. http://192.168.1.50:49153/nmrDescription.xml), **not** just the IP. Press **Discover** to auto-detect the DLNA renderers on your network and pick one from the list. |
+| Additional Players | (Sonos / Google Cast / DLNA) Add additional players so your announcement is played on all of them at once. For Sonos they are grouped to the Main Player coordinator; for Google Cast and DLNA the TTS is played on every device in parallel. Use the "ADD" button below the list; for each additional player you can adjust its volume relative to the main volume (-100/+100). |
 
 **Google TTS Engines specific options**
 |Property|Description|
@@ -638,10 +857,23 @@
 | Stability | Only avaiable with Elevenlabs. Please refer to Elevenlabs.io description. Values from 0 to 1 (for example 0.2, 0.7, etc.) |
 | Similarity | Only avaiable with Elevenlabs. Please refer to Elevenlabs.io description. Values from 0 to 1 (for example 0.2, 0.7, etc.) |
 | Style Exaggeration | Only avaiable with Elevenlabs. Please refer to Elevenlabs.io description. Values from 0 to 1 (for example 0.2, 0.7, etc.)|
+| Speed | Only avaiable with Elevenlabs v2. Controls the speaking speed. Values between 0.7 (slower) and 1.2 (faster), default 1.0. |
 | Speaker boost | Only avaiable with Elevenlabs. Please refer to Elevenlabs.io description. Values from 0 to 1 (for example 0.2, 0.7, etc.) |
+| Model | The model list is read directly from ElevenLabs (press the refresh icon to reload it), so new models appear automatically. Options not supported by the selected model (such as Style Exaggeration or Speaker boost) are automatically disabled, based on the model capabilities reported by ElevenLabs. Leave on "Automatic" to let the node pick a sensible default. |
 
 <br/>
 
+**Players**
+
+| Player | Notes |
+|--|--|
+| Sonos | Native control: grouping, volume, mute/unmute and music resume after the announcement. |
+| Google Cast | Chromecast and Google Nest devices, discovered via mDNS. Set the main device IP and, optionally, additional devices for synchronized multi-room playback. |
+| DLNA / UPnP renderer | Generic UPnP MediaRenderers (smart TVs, AV receivers, etc.), discovered via SSDP. Works with renderers that nest a MediaRenderer sub-device too (e.g. Sonos). Requires the full device description XML URL. |
+| No player | Only generates the mp3 file(s) and outputs their paths in filesArray, to be played by third party nodes. |
+
+For Google Cast and DLNA the device fetches the generated mp3 over HTTP from Node-RED, so the Node-RED host/port (default 1980) must be reachable from the player and on the same subnet (mDNS/SSDP discovery does not cross subnets/VLANs).
+
 ### Inputs
 
 : volume (string) : Set the volume (values between "0" and "100").