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

package/ttsultimate/ttsultimate-config.html

@@ -218,8 +218,8 @@
 # TTS Service node
 Here you can set all parameters you need. All nodes will refer to this config node, so you need to set it only once.<br/> 
 IF YOU RUN NODE-RED BEHIND DOCKER OR SOMETHING ELSE, BE AWARE: <br/>
-PORT USED BY THE NODE ARE 1980 (DEFAULT) AND 1400 (FOR SONOS DISCOVER). <br/>
-PLEASE ALLOW MDNS AND UDP AS WELL
+PORT USED BY THE NODE ARE 1980 (DEFAULT, HTTP FILE SERVER) AND 1400 (FOR SONOS DISCOVER). <br/>
+PLEASE ALLOW MDNS AND UDP AS WELL (USED TO DISCOVER SONOS, GOOGLE CAST AND DLNA/UPNP DEVICES)
 
 	**TTS Service**<br/>
 	You can choose between Google (without credentials), Google TTS (require credentials and registration to google), ElevenLabs or Voice.ai TTS engines.<br/>
@@ -262,7 +262,7 @@ PLEASE ALLOW MDNS AND UDP AS WELL
 set IP of your node-red machine. Write **AUTODISCOVER** to allow the node to auto discover your IP.
 
 **Host Port**<br/>
-Sonos will connect to this port in order to play TTS. Default 1980. Choose a free port. Do not use 1880 or any other port already in use on your computer.
+The players (Sonos, Google Cast, DLNA/UPnP renderers) will connect to this port to fetch the TTS audio. Default 1980. Choose a free port. Do not use 1880 or any other port already in use on your computer. The port must be reachable from the players on your network.
 
 **TTS Cache**
 <br/>

package/ttsultimate/ttsultimate-config.js

@@ -11,7 +11,7 @@ module.exports = function (RED) {
 
     // Setting up the engines
     const GoogleTTS = require('@google-cloud/text-to-speech');
-    const GoogleTranslate = require('google-translate-tts'); // TTS without credentials, limited to 200 chars per row.
+    const GoogleTranslate = require('./lib/googletranslate'); // Native TTS without credentials, limited to 200 chars per row.
     const elevenlabsTTS = require("elevenlabs-node"); // 03/08/2023
     const ElevenLabsClient = require("elevenlabs").ElevenLabsClient;
 
@@ -20,6 +20,8 @@ module.exports = function (RED) {
     var formidable = require('formidable');
     const oOS = require('os');
     const sonos = require('sonos');
+    const dlnaDiscovery = require('./lib/dlna-discovery'); // 06/2026 SSDP discovery of DLNA/UPnP renderers
+    const castDiscovery = require('./lib/googlecast-discovery'); // 06/2026 mDNS discovery of Google Cast devices
 
     const VOICEAI_API_BASE_URL = "https://dev.voice.ai/api/v1/tts";
 
@@ -326,6 +328,38 @@ module.exports = function (RED) {
         });
 
 
+        // 06/2026 Discover DLNA/UPnP MediaRenderers on the network (for the "dlna" player type)
+        RED.httpAdmin.get("/ttsultimateDiscoverDLNA", RED.auth.needsPermission('TTSConfigNode.read'), function (req, res) {
+            dlnaDiscovery.discoverRenderers({ timeoutMs: 4000 }).then((devices) => {
+                // Same shape as sonosgetAllGroups: { name, host }. For DLNA the "host" is the description URL.
+                const list = devices.map((d) => ({
+                    name: d.name || "Renderer",
+                    host: d.location
+                }));
+                res.json(list);
+            }).catch((error) => {
+                RED.log.warn('ttsultimate-config ' + node.id + ': Error discovering DLNA renderers ' + error.message);
+                res.json("ERRORDISCOVERY");
+            });
+        });
+
+
+        // 06/2026 Discover Google Cast devices (Chromecast / Nest) on the network (for the "googlecast" player type)
+        RED.httpAdmin.get("/ttsultimateDiscoverCast", RED.auth.needsPermission('TTSConfigNode.read'), function (req, res) {
+            castDiscovery.discoverCastDevices({ timeoutMs: 4000 }).then((devices) => {
+                // Same shape as sonosgetAllGroups: { name, host }
+                const list = devices.map((d) => ({
+                    name: d.name,
+                    host: d.host
+                }));
+                res.json(list);
+            }).catch((error) => {
+                RED.log.warn('ttsultimate-config ' + node.id + ': Error discovering Google Cast devices ' + error.message);
+                res.json("ERRORDISCOVERY");
+            });
+        });
+
+
         // 09/03/2020 Get list of filenames in hailing folder
         RED.httpAdmin.get("/getHailingFilesList", RED.auth.needsPermission('TTSConfigNode.read'), function (req, res) {
             var jListOwnFiles = [];
@@ -505,6 +539,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
 
@@ -640,45 +714,81 @@ module.exports = function (RED) {
                 var url_parts = url.parse(req.url, true);
                 var query = url_parts.query;
 
-                res.setHeader('Content-Disposition', 'attachment; filename=tts.mp3')
                 if (!query || query.f === undefined || query.f === null) {
-                    res.write("File not specified");
-                    res.end();
+                    res.statusCode = 400;
+                    res.end("File not specified");
                     return;
                 }
 
                 const requestedPath = query.f.toString();
-                if (fs.existsSync(requestedPath)) {
-                    // Security check: allow only mp3 files under the configured storage folder.
-                    const resolvedRequested = path.resolve(requestedPath);
-                    const resolvedAllowedRoot = path.resolve(node.TTSRootFolderPath);
-                    const isInsideRoot =
-                        resolvedRequested === resolvedAllowedRoot || resolvedRequested.startsWith(resolvedAllowedRoot + path.sep);
-
-                    if (path.extname(resolvedRequested) === ".mp3" && isInsideRoot) {
-                        var readStream = fs.createReadStream(resolvedRequested);
-                        readStream.on("error", function (error) {
-                            RED.log.error("ttsultimate-config " + node.id + ": Playsonos error opening stream : " + resolvedRequested + ' : ' + error);
-                            res.end();
-                            return;
-                        });
-                        readStream.pipe(res);
-                    } else {
-                        res.write("NOT ALLOWED");
-                        res.end();
-                    }
+                if (!fs.existsSync(requestedPath)) {
+                    RED.log.error("ttsultimate-config " + node.id + ": Playsonos RED.httpAdmin file not found: " + query.f);
+                    res.statusCode = 404;
+                    res.end("File not found");
+                    return;
+                }
 
-                    // http://localhost:1980/tts?f=/etc/passwd                 
+                // Security check: allow only mp3 files under the configured storage folder.
+                // http://localhost:1980/tts?f=/etc/passwd
+                const resolvedRequested = path.resolve(requestedPath);
+                const resolvedAllowedRoot = path.resolve(node.TTSRootFolderPath);
+                const isInsideRoot =
+                    resolvedRequested === resolvedAllowedRoot || resolvedRequested.startsWith(resolvedAllowedRoot + path.sep);
+                if (path.extname(resolvedRequested) !== ".mp3" || !isInsideRoot) {
+                    res.statusCode = 403;
+                    res.end("NOT ALLOWED");
+                    return;
+                }
 
-                } else {
-                    RED.log.error("ttsultimate-config " + node.id + ": Playsonos RED.httpAdmin file not found: " + query.f);
-                    res.write("File not found");
+                // Serve as a proper streaming media response. Strict DLNA renderers (e.g. some TVs)
+                // require Content-Type, Content-Length, byte-range support and DLNA headers to start playing.
+                const total = fs.statSync(resolvedRequested).size;
+                res.setHeader('Content-Type', 'audio/mpeg');
+                res.setHeader('Content-Disposition', 'inline; filename="tts.mp3"');
+                res.setHeader('Accept-Ranges', 'bytes');
+                res.setHeader('transferMode.dlna.org', 'Streaming');
+                res.setHeader('contentFeatures.dlna.org', 'DLNA.ORG_OP=01;DLNA.ORG_CI=0;DLNA.ORG_FLAGS=01700000000000000000000000000000');
+
+                // HEAD: headers only (many DLNA renderers probe with HEAD before playing).
+                if (req.method === 'HEAD') {
+                    res.setHeader('Content-Length', total);
+                    res.statusCode = 200;
                     res.end();
+                    return;
                 }
 
+                let readStream;
+                const range = req.headers.range;
+                if (range) {
+                    const m = /bytes=(\d*)-(\d*)/.exec(range);
+                    let start = m && m[1] ? parseInt(m[1], 10) : 0;
+                    let end = m && m[2] ? parseInt(m[2], 10) : total - 1;
+                    if (isNaN(start)) start = 0;
+                    if (isNaN(end) || end >= total) end = total - 1;
+                    if (start > end || start >= total) {
+                        res.statusCode = 416;
+                        res.setHeader('Content-Range', 'bytes */' + total);
+                        res.end();
+                        return;
+                    }
+                    res.statusCode = 206;
+                    res.setHeader('Content-Range', 'bytes ' + start + '-' + end + '/' + total);
+                    res.setHeader('Content-Length', (end - start) + 1);
+                    readStream = fs.createReadStream(resolvedRequested, { start: start, end: end });
+                } else {
+                    res.statusCode = 200;
+                    res.setHeader('Content-Length', total);
+                    readStream = fs.createReadStream(resolvedRequested);
+                }
+                readStream.on("error", function (error) {
+                    RED.log.error("ttsultimate-config " + node.id + ": Playsonos error opening stream : " + resolvedRequested + ' : ' + error);
+                    try { res.end(); } catch (e) { }
+                });
+                readStream.pipe(res);
+
             } catch (error) {
                 RED.log.error("ttsultimate-config " + node.id + ": Playsonos RED.httpAdmin error: " + error);
-                res.end();
+                try { res.end(); } catch (e) { }
             }
 
         }