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

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 [![Donate via PayPal](https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square)](https://www.paypal.me/techtoday)
 
+<b>Version 3.1.1</b> June 2026<br/>
+
+- NEW: voice option fields (ElevenLabs Stability/Similarity/Style/Speed and Google Rate/Pitch) are now sliders showing the current value live.<br/>
+</p>
+
+<p>
+<b>Version 3.1.0</b> June 2026<br/>
+
+- NEW: refresh icon next to the "Voice" field to reload the voices list on demand.<br/>
+- NEW: ElevenLabs models are now read dynamically from the API (with a refresh icon), so new models appear automatically. Model-specific options (Style Exaggeration, Speaker boost) are enabled/disabled based on the capabilities reported by ElevenLabs.<br/>
+- NEW: ElevenLabs "Speed" option (0.7 - 1.2, default 1.0) for the v2 engine.<br/>
+</p>
+
+<p>
 <b>Version 3.0.7</b> March 2026<br/>
 
 - CHORE: fixed some issues with voice.ai.<br/>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-contrib-tts-ultimate",
-  "version": "3.0.7",
+  "version": "3.1.1",
   "description": "Transforms the text in speech and hear it using Sonos player or generate an audio file to be used with third parties nodes. Works with voices from Google (without credentials as well), Google TTS, ElevenLabs.io TTS, Voice.ai TTS or your own voice. You can also only create a TTS file to be read by third party nodes. Update of the popular SonosPollyTTS node.",
   "main": "index.js",
   "scripts": {

package/ttsultimate/ttsultimate-config.js

@@ -505,6 +505,46 @@ module.exports = function (RED) {
 
         });
 
+        // 10/06/2026 Supergiovane, get the available ElevenLabs models with their capabilities.
+        // Used to dynamically populate the Model dropdown and enable/disable model-specific options.
+        RED.httpAdmin.get("/ttsgetmodels" + encodeURIComponent(node.id), RED.auth.needsPermission('TTSConfigNode.read'), function (req, res) {
+            const ttsservice = req.query.ttsservice || node.ttsservice;
+            if (!ttsservice || !ttsservice.includes("elevenlabs")) {
+                return res.json([]);
+            }
+            const apiKey = node.credentials.elevenlabsKey;
+            if (!apiKey || apiKey.trim() === "") {
+                return res.json([{ model_id: "", name: "ElevenLabs API key missing. Please configure, deploy and restart node-red.", error: true }]);
+            }
+            (async () => {
+                try {
+                    const r = await fetch("https://api.elevenlabs.io/v1/models", {
+                        method: "GET",
+                        headers: { "xi-api-key": apiKey }
+                    });
+                    if (!r.ok) {
+                        const body = await r.text().catch(() => "");
+                        throw new Error(`HTTP ${r.status} ${r.statusText}${body ? " - " + body : ""}`);
+                    }
+                    const models = await r.json();
+                    const list = (Array.isArray(models) ? models : [])
+                        .filter(m => m && m.model_id && m.can_do_text_to_speech !== false)
+                        .map(m => ({
+                            model_id: m.model_id,
+                            name: m.name || m.model_id,
+                            can_use_style: m.can_use_style === true,
+                            can_use_speaker_boost: m.can_use_speaker_boost === true,
+                            maximum_text_length_per_request: m.maximum_text_length_per_request,
+                            languages: Array.isArray(m.languages) ? m.languages.map(l => l.name || l.language_id).filter(Boolean) : []
+                        }));
+                    res.json(list);
+                } catch (error) {
+                    RED.log.error('ttsultimate-config ' + node.id + ': Error getting ElevenLabs models: ' + error.message);
+                    res.json([{ model_id: "", name: "Error getting ElevenLabs models: " + error.message + " Check credentials, deploy and restart node-red.", error: true }]);
+                }
+            })();
+        });
+
         // ########################################################
         //#endregion
 

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>
@@ -201,6 +223,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 +253,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 +288,7 @@
 	          try {
 	            oNodeServer = RED.nodes.node($(this).val());
 	            getVoices();
+	            getElevenLabsModels();
 	            updateTtsOptionsVisibility();
 	          } catch (error) {
 	          }
@@ -363,8 +388,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 = () => {
@@ -638,7 +748,9 @@
 | 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/>
 

package/ttsultimate/ttsultimate.js

@@ -746,6 +746,7 @@ module.exports = function (RED) {
                 const stability = config.elevenlabsStability !== undefined && config.elevenlabsStability !== "" ? Number(config.elevenlabsStability) : undefined;
                 const similarity = config.elevenlabsSimilarity_boost !== undefined && config.elevenlabsSimilarity_boost !== "" ? Number(config.elevenlabsSimilarity_boost) : undefined;
                 const style = config.elevenlabsStyle !== undefined && config.elevenlabsStyle !== "" ? Number(config.elevenlabsStyle) : undefined;
+                const speed = config.elevenlabsSpeed !== undefined && config.elevenlabsSpeed !== "" ? Number(config.elevenlabsSpeed) : undefined;
                 const resolvedModel = config.elevenlabsModel && config.elevenlabsModel !== "" ? config.elevenlabsModel : "eleven_multilingual_v2";
                 const latencyPreset = config.elevenlabsOptimizeLatency && config.elevenlabsOptimizeLatency !== "" ? config.elevenlabsOptimizeLatency : undefined;
                 const outputFormat = config.elevenlabsOutputFormat && config.elevenlabsOutputFormat !== "" ? config.elevenlabsOutputFormat : undefined;
@@ -761,6 +762,7 @@ module.exports = function (RED) {
                 if (stability !== undefined && !Number.isNaN(stability)) params.voice_settings.stability = stability;
                 if (similarity !== undefined && !Number.isNaN(similarity)) params.voice_settings.similarity_boost = similarity;
                 if (style !== undefined && !Number.isNaN(style)) params.voice_settings.style = style;
+                if (speed !== undefined && !Number.isNaN(speed)) params.voice_settings.speed = speed;
                 params.voice_settings.use_speaker_boost = useSpeakerBoost;
                 if (Object.keys(params.voice_settings).length === 0) delete params.voice_settings;
                 if (latencyPreset !== undefined) params.optimize_streaming_latency = latencyPreset;