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

package/CHANGELOG.md

@@ -5,8 +5,9 @@
 ## BREAKING CHANGE ! BREAKING CHANGE ! BREAKING CHANGE ! BREAKING CHANGE !
 
 <p>
-<b>Version 3.0.0</b> April 2025<br/>
+<b>Version 3.0.0</b> June 2025<br/>
 - BREAKING CHANGE: Amazon Polly and Microsoft Azure TTS have been removed due to lack of time to update the old and complex API's. Anyone can add these again by forking the project and do a PR. Thank you!. If you still need those TTS, please stay or revert to 2.0.10.<br/>
+- NEW: Added option to avoid resuming music if it was playing before TTS messages.<br/>
 </p>
 
 -----------------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-contrib-tts-ultimate",
-  "version": "3.0.0",
+  "version": "3.0.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 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

@@ -79,7 +79,10 @@
             <label for="node-input-unmuteIfMuted"><i class="fa fa-bell-slash-o"></i> Unmute</label>
             <input type="checkbox" id="node-input-unmuteIfMuted" style="margin-left: 0px; vertical-align: top; width: auto !important;"> <label style="width:auto !important;"> Unmute, then restore previous state after play.</label>
         </div>
-        
+         <div class="form-row">
+            <label for="node-input-doNotResumeMusic"><i class="fa fa-bell-slash-o"></i> Resume</label>
+            <input type="checkbox" id="node-input-doNotResumeMusic" style="margin-left: 0px; vertical-align: top; width: auto !important;"> <label style="width:auto !important;"> Do not resume previous music.</label>
+        </div>
         <div class="form-row">
             <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>
@@ -136,6 +139,12 @@
           value: "Hailing_Hailing.mp3",
           required: false,
         },
+        doNotResumeMusic:
+        {
+          value: true,
+          required: false,
+        },
+
         config:
         {
           type: "ttsultimate-config",
@@ -549,6 +558,7 @@
 | 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. |
 | 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. |
 | 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. |
 

package/ttsultimate/ttsultimate.js

@@ -80,7 +80,7 @@ module.exports = function (RED) {
     node.sonosCoordinatorIsPreviouslyMuted = false;
     node.passThroughMessage = {};
     node.bTimeOutPlay = false;
-
+    node.doNotResumeMusic = config.doNotResumeMusic === undefined ? false : config.doNotResumeMusic; // 06/2025 Do not resume previous music after TTS, if playing.
     if (typeof node.server !== "undefined" && node.server !== null) {
       node.sNoderedURL = node.server.sNoderedURL || "";
     }
@@ -857,37 +857,39 @@ module.exports = function (RED) {
           await delay(2000);
 
           // Resume music
-          try {
-            if (oCurTrack !== null && (!oCurTrack.hasOwnProperty("title") || oCurTrack.title.indexOf(".mp3") === -1)) {
-              node.setNodeStatus({ fill: 'grey', shape: 'ring', text: "Resuming original queue..." });
-              await resumeMusicQueue(oCurTrack);
-              node.setNodeStatus({ fill: 'green', shape: 'ring', text: "Done resuming queue." });
-            } else {
-              // 28/08/2021 There was no queue playing. Delete the TTS from the queue
-              node.setNodeStatus({ fill: 'green', shape: 'ring', text: "No queue to resume." });
+          if (!node.doNotResumeMusic) {
+            try {
+              if (oCurTrack !== null && (!oCurTrack.hasOwnProperty("title") || oCurTrack.title.indexOf(".mp3") === -1)) {
+                node.setNodeStatus({ fill: 'grey', shape: 'ring', text: "Resuming original queue..." });
+                await resumeMusicQueue(oCurTrack);
+                node.setNodeStatus({ fill: 'green', shape: 'ring', text: "Done resuming queue." });
+              } else {
+                // 28/08/2021 There was no queue playing. Delete the TTS from the queue
+                node.setNodeStatus({ fill: 'green', shape: 'ring', text: "No queue to resume." });
+              }
+            } catch (error) {
+              node.setNodeStatus({ fill: 'red', shape: 'ring', text: "Error resuming queue: " + error.message });
             }
-          } catch (error) {
-            node.setNodeStatus({ fill: 'red', shape: 'ring', text: "Error resuming queue: " + error.message });
           }
 
-
           // 19/04/2022 Resume music queue of additional players
-          for (let index = 0; index < node.oAdditionalSonosPlayers.length; index++) {
-            let addPlayer = node.oAdditionalSonosPlayers[index].oPlayer;
-            let trackAddPlayer = addPlayer.additionalPlayerCurrentTrack;
-            if (trackAddPlayer !== null) {
-              try {
-                await resumeMusicQueue(trackAddPlayer, addPlayer);
-                node.setNodeStatus({ fill: 'green', shape: 'ring', text: "Done resuming queue additional player " + addPlayer.host || "" });
-              } catch (error) {
-                // Dont care
-                RED.log.warn("ttsultimate: Error resuming music queue of additional player " + error.message + " " + addPlayer.host || "");
+          if (!node.doNotResumeMusic) {
+            for (let index = 0; index < node.oAdditionalSonosPlayers.length; index++) {
+              let addPlayer = node.oAdditionalSonosPlayers[index].oPlayer;
+              let trackAddPlayer = addPlayer.additionalPlayerCurrentTrack;
+              if (trackAddPlayer !== null) {
+                try {
+                  await resumeMusicQueue(trackAddPlayer, addPlayer);
+                  node.setNodeStatus({ fill: 'green', shape: 'ring', text: "Done resuming queue additional player " + addPlayer.host || "" });
+                } catch (error) {
+                  // Dont care
+                  RED.log.warn("ttsultimate: Error resuming music queue of additional player " + error.message + " " + addPlayer.host || "");
+                }
+              } else {
+                node.setNodeStatus({ fill: 'green', shape: 'ring', text: "No queue to resume for " + addPlayer.host || "" });
               }
-            } else {
-              node.setNodeStatus({ fill: 'green', shape: 'ring', text: "No queue to resume for " + addPlayer.host || "" });
             }
           }
-
           // Signal end playing
           let t = setTimeout(() => {
             node.msg.completed = true;