node-red-contrib-tts-ultimate 3.0.1 → 3.0.2

package/CHANGELOG.md

@@ -2,7 +2,11 @@
 
 [![Donate via PayPal](https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square)](https://www.paypal.me/techtoday) 
 
-## BREAKING CHANGE ! BREAKING CHANGE ! BREAKING CHANGE ! BREAKING CHANGE !
+
+<p>
+<b>Version 3.0.1</b> October 2025<br/>
+- Elevenlabs Engine: added more option to personalize the voice.<br/>
+</p>
 
 <p>
 <b>Version 3.0.0</b> June 2025<br/>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-contrib-tts-ultimate",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "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 Amazon, Google (without credentials as well), Microsoft TTS Azure, ElevenLabs.io 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.html

@@ -49,6 +49,47 @@
           <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>
+            <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>
+        </div>
+        <div class="form-row">
+          <label for="node-input-elevenlabsOptimizeLatency"><i class="fa fa-tachometer"></i> Latency preset</label>
+          <select id="node-input-elevenlabsOptimizeLatency" style="width:60%">
+            <option value="">Default</option>
+            <option value="0">0 - Best quality</option>
+            <option value="1">1</option>
+            <option value="2">2</option>
+            <option value="3">3</option>
+            <option value="4">4 - Lowest latency</option>
+          </select>
+        </div>
+        <div class="form-row">
+          <label for="node-input-elevenlabsOutputFormat"><i class="fa fa-file-audio-o"></i> Output format</label>
+          <select id="node-input-elevenlabsOutputFormat" style="width:60%">
+            <option value="">Default (mp3_44100_128)</option>
+            <option value="mp3_44100_192">mp3_44100_192</option>
+            <option value="mp3_44100_128">mp3_44100_128</option>
+            <option value="mp3_44100_64">mp3_44100_64</option>
+            <option value="mp3_44100_32">mp3_44100_32</option>
+            <option value="mp3_22050_128">mp3_22050_128</option>
+            <option value="mp3_22050_64">mp3_22050_64</option>
+            <option value="pcm_16000">pcm_16000</option>
+            <option value="pcm_22050">pcm_22050</option>
+            <option value="ulaw_8000">ulaw_8000</option>
+          </select>
+        </div>
+        <div class="form-row">
+          <label for="node-input-elevenlabsSeed"><i class="fa fa-random"></i> Seed</label>
+          <input type="text" id="node-input-elevenlabsSeed" style="width:120px" placeholder="Leave blank for random">
+        </div>
     </div>
     <div class="form-row" id="divSSML">
         <label></label>
@@ -161,6 +202,10 @@
         elevenlabsSimilarity_boost: { value: "0.5", required: false },
         elevenlabsStyle: { value: "0.0", required: false },
         elevenlabsUse_speaker_boost: { value: true, required: false },
+        elevenlabsModel: { value: "", required: false },
+        elevenlabsOptimizeLatency: { value: "", required: false },
+        elevenlabsOutputFormat: { value: "", required: false },
+        elevenlabsSeed: { value: "", required: false },
       },
       inputs: 1,
       outputs: 2,
@@ -184,6 +229,10 @@
       oneditprepare: function () {
         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.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);
 
         // 19/02/2020 Used to alert the user if the CSV file has not been loaded and to get the server sooner als deploy
         // ###########################
@@ -612,4 +661,4 @@ The node has two output pins. The first pin is to signal play status, the second
 [Find it useful?](https://www.paypal.me/techtoday)
 
 <br/>
-</script>
+</script>

package/ttsultimate/ttsultimate.js

@@ -660,15 +660,18 @@ module.exports = function (RED) {
                 }
               } else if (node.server.ttsservice === "elevenlabs") {
                 // VoiceId is: code 
+                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 resolvedModel = config.elevenlabsModel && config.elevenlabsModel !== "" ? config.elevenlabsModel : "eleven_monolingual_v1";
                 const params = {
                   text: msg,
                   voice: node.voiceId,
-                  model_id: "eleven_monolingual_v1",
-                  voice_settings: {
-                    stability: config.elevenlabsStability,
-                    similarity_boost: config.elevenlabsSimilarity_boost
-                  }
+                  model_id: resolvedModel,
+                  voice_settings: {}
                 };
+                if (stability !== undefined && !Number.isNaN(stability)) params.voice_settings.stability = stability;
+                if (similarity !== undefined && !Number.isNaN(similarity)) params.voice_settings.similarity_boost = similarity;
+                if (Object.keys(params.voice_settings).length === 0) delete params.voice_settings;
                 // Download or read from cache
                 node.sFileToBePlayed = getFilename(msg, params);
                 node.sFileToBePlayed = path.join(node.userDir, "ttsfiles", node.sFileToBePlayed);
@@ -680,18 +683,29 @@ module.exports = function (RED) {
                 }
               } else if (node.server.ttsservice === "elevenlabsv2") {
                 // VoiceId is: code 
+                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 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;
+                const seed = config.elevenlabsSeed && config.elevenlabsSeed !== "" ? Number(config.elevenlabsSeed) : undefined;
+                const useSpeakerBoost = config.elevenlabsUse_speaker_boost === undefined ? true : config.elevenlabsUse_speaker_boost;
                 const params = {
                   stream: false,
                   text: msg,
                   voice: node.voiceId,
-                  model_id: "eleven_multilingual_v2",
-                  voice_settings: {
-                    stability: config.elevenlabsStability,
-                    similarity_boost: config.elevenlabsSimilarity_boost,
-                    style: config.elevenlabsStyle || 0,
-                    use_speaker_boost: config.elevenlabsUse_speaker_boost === undefined ? true : config.elevenlabsUse_speaker_boost
-                  }
+                  model_id: resolvedModel,
+                  voice_settings: {}
                 };
+                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;
+                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;
+                if (outputFormat !== undefined) params.output_format = outputFormat;
+                if (seed !== undefined && !Number.isNaN(seed)) params.seed = seed;
                 // Download or read from cache
                 node.sFileToBePlayed = getFilename(msg, params);
                 node.sFileToBePlayed = path.join(node.userDir, "ttsfiles", node.sFileToBePlayed);
@@ -1194,7 +1208,10 @@ module.exports = function (RED) {
       }
       return new Promise((resolve, reject) => {
         // "model_id": "eleven_multilingual_v1",
-        ttsService.textToSpeechStream(node.server.credentials.elevenlabsKey, params.voice, params.text, null, null, "eleven_multilingual_v1").then((res) => {
+        const stability = params.voice_settings && params.voice_settings.stability !== undefined ? params.voice_settings.stability : null;
+        const similarity = params.voice_settings && params.voice_settings.similarity_boost !== undefined ? params.voice_settings.similarity_boost : null;
+        const model = params.model_id !== undefined && params.model_id !== "" ? params.model_id : "eleven_monolingual_v1";
+        ttsService.textToSpeechStream(node.server.credentials.elevenlabsKey, params.voice, params.text, stability, similarity, model).then((res) => {
           try {
             if (res !== undefined) {
               resolve(stream2buffer(res));