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

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 [![Donate via PayPal](https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square)](https://www.paypal.me/techtoday)
 
+<b>Version 3.2.0</b> June 2026<br/>
+
+- NEW: **Google Cast** player (Chromecast / Google Nest). Devices are discovered via mDNS (press "Discover" in the node), with multi-room playback on the main device + additional players.<br/>
+- NEW: **DLNA / UPnP renderer** player (smart TVs, AV receivers, etc.). Devices are discovered via SSDP. A native UPnP client locates the AVTransport/RenderingControl services anywhere in the device tree, so it also works with renderers that nest a MediaRenderer sub-device (e.g. Sonos).<br/>
+- NEW: the "Additional players" list now works for Google Cast and DLNA too (not only Sonos), to play the announcement on several devices at once.<br/>
+- FIX: the built-in HTTP file server now serves the TTS audio with proper streaming headers (Content-Type, Content-Length, byte-range support and DLNA headers), so strict DLNA renderers (some TVs) start playing correctly.<br/>
+- CHORE: removed the "upnp-mediarenderer-client" dependency (replaced by a native UPnP client); added "castv2-client" and "multicast-dns".<br/>
+</p>
+
+<p>
+<b>Version 3.1.2</b> June 2026<br/>
+
+- CHORE: removed the external "google-translate-tts" dependency, replaced by a native built-in implementation (same voices and behaviour).<br/>
+- CHORE: removed the redundant "path" dependency (Node.js built-in module is used instead).<br/>
+</p>
+
+<p>
 <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/>

package/README.md

@@ -161,7 +161,7 @@
 
 ## DESCRIPTION
 
-This node transforms a text into a speech audio that you can hear natively via <b>SONOS</b> speakers, but you can also simply create an audio file, without using SONOS at all.<br/>
+This node transforms a text into a speech audio that you can hear natively via <b>Sonos</b> speakers, <b>Google Cast</b> devices (Chromecast / Google Nest) and generic <b>DLNA/UPnP</b> renderers (smart TVs, AV receivers, etc.), but you can also simply create an audio file, without using any player at all.<br/>
 You can also generate an audio file for bluetooth speakers, web pages, etc.<br/>
 You can also use it with **your own audio file** as well and it can be used **totally offline** even without the use of TTS, without internet connection.<br/>
 The node can also create a **_TTS file (without the use of any Sonos device)_**, to be read by third parties nodes.<br/>
@@ -193,10 +193,12 @@ This is a major **_upgrade from the previously popular node SonosPollyTTS_** (So
 ## FEATURES
 
 - **Native Sonos support**: hear the TTS audio directly via Sonos. You can also group speakers, set an hailing sound, choose the volume of each speaker etc.
-- **Output audio file**: the node can just create the TTS file to be used by other nodes. In this case, you doesn't need to use Sonos as player.
+- **Google Cast support** (Chromecast / Google Nest): play the TTS directly on your Cast devices, with multi-room playback on several devices at once.
+- **DLNA / UPnP renderer support**: play the TTS on generic UPnP renderers (smart TVs, AV receivers, etc.). It also works with renderers that nest a MediaRenderer sub-device (e.g. Sonos).
+- **Output audio file**: the node can just create the TTS file to be used by other nodes. In this case, you don't need to use any player.
 - **Google Translate Voices, Google TTS Voices, ElevenLabs voices and Voice.ai voices** are supported.
-- **Automatic grouping** is supported. You can group all players you want to play your announcements.
-- **Automatic discovery** of your players.
+- **Automatic grouping / multi-room** is supported on Sonos, Google Cast and DLNA. You can add additional players to play your announcements on all of them at once.
+- **Automatic discovery** of your players: Sonos and DLNA/UPnP renderers via SSDP, Google Cast devices via mDNS. A "Discover" button in the node lists the devices found on your network.
 - **Automatic resume of music** queue (including radio stations, but here, some users reports problem resuming **_radio stations_** and, because of lack of Sonos API documentation, the issue cannot currently be fixed), at exact track, at exact time. **Be aware that this could not work with all music queues**.
 - **TTS caching**. ElevenLabs and Google paid service charge you for a high rate of text-to-speech requests. TTS-Ultimate caches the TTS files: it downloads each generated audio only once, and then reads it from cache. The cache is resilient (survives reboots and updates).
 - **Can work offline**. You can use your own audio files (with OwnFile node) to make the node works offline.
@@ -224,7 +226,7 @@ This is a major **_upgrade from the previously popular node SonosPollyTTS_** (So
 
 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/>
+PORT USED BY THE NODE ARE 1980 (DEFAULT, HTTP FILE SERVER) AND 1400 (FOR SONOS DISCOVER). <br/>
 PLEASE ALLOW MDNS AND UDP AS WELL
 
 **TTS Service**<br/>
@@ -265,7 +267,7 @@ For Google TTS Engine, you can choose pitch and speed rate of the voice.
 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.
 
 Note: if you use multiple `ttsultimate-config` nodes, each one now keeps its own TTS cache folder; the “purge on restart/deploy” option only affects that config node’s cache.
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "node-red-contrib-tts-ultimate",
-  "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.",
+  "version": "3.2.0",
+  "description": "Transforms the text in speech and hear it using Sonos, Google Cast (Chromecast / Nest) or DLNA/UPnP players, 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": {
     "test": "test",
@@ -39,13 +39,13 @@
   },
   "homepage": "https://github.com/Supergiovane/node-red-contrib-tts-ultimate",
   "dependencies": {
-    "sonos": "1.14.1",
-    "formidable": "1.2.2",
-    "path": ">=0.12.7",
     "@google-cloud/text-to-speech": "4.2.2",
-    "google-translate-tts": ">=0.3.0",
+    "castv2-client": "^1.2.0",
+    "elevenlabs": "0.18.0",
     "elevenlabs-node": "1.1.3",
-    "elevenlabs": "0.18.0"
+    "formidable": "1.2.2",
+    "multicast-dns": "^7.2.5",
+    "sonos": "1.14.1"
   },
   "devDependencies": {
     "eslint": ">=4.18.2",
@@ -54,4 +54,4 @@
   "engines": {
     "node": ">=22.0.0"
   }
-}
+}

package/scripts/discover-dlna.js

@@ -0,0 +1,44 @@
+// Discover DLNA / UPnP MediaRenderer devices on the local network.
+// Prints the device description XML URL (LOCATION) to paste into the
+// tts-ultimate "DLNA / UPnP renderer" player configuration.
+//
+// Usage:
+//   node scripts/discover-dlna.js            (search ~5s)
+//   node scripts/discover-dlna.js --timeout 8000
+const { discoverRenderers } = require("../ttsultimate/lib/dlna-discovery");
+
+const argValue = (name, fallback) => {
+  const idx = process.argv.indexOf(name);
+  if (idx === -1) return fallback;
+  const value = process.argv[idx + 1];
+  return value && !value.startsWith("--") ? value : fallback;
+};
+
+const timeoutMs = Number(argValue("--timeout", 5000)) || 5000;
+
+(async () => {
+  // eslint-disable-next-line no-console
+  console.log(`Searching for DLNA/UPnP MediaRenderers for ${timeoutMs} ms...\n`);
+  const devices = await discoverRenderers({ timeoutMs });
+  if (devices.length === 0) {
+    // eslint-disable-next-line no-console
+    console.log("No MediaRenderer devices found. Make sure a renderer is on and on the same subnet.");
+    process.exit(0);
+  }
+  // eslint-disable-next-line no-console
+  console.log(`Found ${devices.length} renderer(s):\n`);
+  for (const dev of devices) {
+    // eslint-disable-next-line no-console
+    console.log("  " + (dev.name || "(unknown name)"));
+    // eslint-disable-next-line no-console
+    console.log("    Description URL (paste this in the node): " + dev.location);
+    if (dev.server) console.log("    Server: " + dev.server);
+    // eslint-disable-next-line no-console
+    console.log("");
+  }
+  process.exit(0);
+})().catch((err) => {
+  // eslint-disable-next-line no-console
+  console.error(err);
+  process.exit(1);
+});

package/scripts/verify-googletranslate-split.js

@@ -1,6 +1,6 @@
 const fs = require("fs");
 const path = require("path");
-const GoogleTranslate = require("google-translate-tts");
+const GoogleTranslate = require("../ttsultimate/lib/googletranslate");
 
 const GOOGLE_TRANSLATE_MAX_CHARS = 200;
 

package/ttsultimate/lib/dlna-discovery.js

@@ -0,0 +1,98 @@
+// Discover DLNA / UPnP MediaRenderer devices on the local network via SSDP.
+// No external dependencies: built-in dgram (UDP multicast) + http only.
+const dgram = require("dgram");
+const http = require("http");
+const { URL } = require("url");
+
+const SSDP_ADDR = "239.255.255.250";
+const SSDP_PORT = 1900;
+const SEARCH_TARGET = "urn:schemas-upnp-org:device:MediaRenderer:1";
+
+// Reads the <friendlyName> from a device description XML URL (best-effort).
+function fetchFriendlyName(location) {
+    return new Promise((resolve) => {
+        try {
+            const u = new URL(location);
+            const req = http.get(
+                { hostname: u.hostname, port: u.port || 80, path: u.pathname + u.search, timeout: 3000 },
+                (res) => {
+                    let body = "";
+                    res.on("data", (c) => (body += c));
+                    res.on("end", () => {
+                        const m = body.match(/<friendlyName>([^<]+)<\/friendlyName>/i);
+                        resolve(m ? m[1].trim() : "");
+                    });
+                }
+            );
+            req.on("error", () => resolve(""));
+            req.on("timeout", () => { req.destroy(); resolve(""); });
+        } catch (e) {
+            resolve("");
+        }
+    });
+}
+
+// discoverRenderers({ timeoutMs }) -> Promise<[{ name, location, server }]>
+function discoverRenderers(options) {
+    const opts = options || {};
+    const timeoutMs = Number(opts.timeoutMs) || 5000;
+    const withNames = opts.withNames !== false; // resolve friendlyName by default
+
+    return new Promise((resolve, reject) => {
+        const found = new Map(); // location -> { location, server }
+        const mSearch = Buffer.from(
+            "M-SEARCH * HTTP/1.1\r\n" +
+            `HOST: ${SSDP_ADDR}:${SSDP_PORT}\r\n` +
+            'MAN: "ssdp:discover"\r\n' +
+            "MX: 2\r\n" +
+            `ST: ${SEARCH_TARGET}\r\n` +
+            "\r\n"
+        );
+
+        let socket;
+        try {
+            socket = dgram.createSocket({ type: "udp4", reuseAddr: true });
+        } catch (error) {
+            reject(error);
+            return;
+        }
+
+        socket.on("message", (msg) => {
+            const text = msg.toString();
+            // Keep only genuine MediaRenderer responses (some non-compliant devices,
+            // e.g. Hue bridges, answer any M-SEARCH; their ST/USN won't mention it).
+            if (!/MediaRenderer/i.test(text)) return;
+            const locationMatch = text.match(/LOCATION:\s*(.+)\r/i);
+            if (!locationMatch) return;
+            const location = locationMatch[1].trim();
+            if (found.has(location)) return;
+            const serverMatch = text.match(/SERVER:\s*(.+)\r/i);
+            found.set(location, { location, server: serverMatch ? serverMatch[1].trim() : "" });
+        });
+
+        socket.on("error", (err) => {
+            try { socket.close(); } catch (e) { }
+            reject(err);
+        });
+
+        socket.bind(() => {
+            try { socket.setBroadcast(true); } catch (e) { }
+            const send = () => { try { socket.send(mSearch, 0, mSearch.length, SSDP_PORT, SSDP_ADDR); } catch (e) { } };
+            send();
+            setTimeout(send, 500);
+            setTimeout(send, 1500);
+
+            setTimeout(async () => {
+                try { socket.close(); } catch (e) { }
+                const devices = Array.from(found.values());
+                if (!withNames) { resolve(devices); return; }
+                for (const dev of devices) {
+                    dev.name = (await fetchFriendlyName(dev.location)) || "";
+                }
+                resolve(devices);
+            }, timeoutMs);
+        });
+    });
+}
+
+module.exports = { discoverRenderers, fetchFriendlyName };

package/ttsultimate/lib/dlna-player.js

@@ -0,0 +1,163 @@
+// Minimal native DLNA / UPnP MediaRenderer control client.
+// Unlike upnp-mediarenderer-client, it locates the AVTransport / RenderingControl
+// services anywhere in the device tree (root device OR embedded <deviceList> devices),
+// so it also works with renderers that nest a MediaRenderer sub-device (e.g. Sonos).
+//
+// It uses only the built-in http module (no XML parser dependency): the UPnP
+// description and SOAP responses are simple enough to read with focused regexes.
+const http = require("http");
+const { URL } = require("url");
+
+function httpRequest(options, body) {
+    return new Promise((resolve, reject) => {
+        const req = http.request(options, (res) => {
+            let data = "";
+            res.on("data", (c) => (data += c));
+            res.on("end", () => resolve({ statusCode: res.statusCode, body: data }));
+        });
+        req.on("error", reject);
+        req.on("timeout", () => { req.destroy(new Error("request timeout")); });
+        if (body) req.write(body);
+        req.end();
+    });
+}
+
+function getText(xml, tag) {
+    const m = xml.match(new RegExp("<" + tag + "[^>]*>([\\s\\S]*?)</" + tag + ">", "i"));
+    return m ? m[1].trim() : "";
+}
+
+function escapeXml(s) {
+    return String(s)
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+
+// Fetch the device description and resolve the (absolute) control URLs for
+// AVTransport and RenderingControl, scanning every <service> in the document.
+async function resolveServices(descriptionUrl) {
+    let u;
+    try {
+        u = new URL(descriptionUrl);
+    } catch (e) {
+        throw new Error('invalid DLNA renderer URL "' + descriptionUrl + '": use the full device description XML URL (e.g. http://192.168.1.50:49153/nmrDescription.xml), not just the IP address');
+    }
+    if (!/^https?:$/.test(u.protocol)) {
+        throw new Error('DLNA renderer URL must start with http:// (got "' + descriptionUrl + '")');
+    }
+    const res = await httpRequest({
+        hostname: u.hostname,
+        port: u.port || 80,
+        path: u.pathname + u.search,
+        method: "GET",
+        timeout: 5000
+    });
+    if (!res.body) throw new Error("empty device description");
+    const xml = res.body;
+    const urlBase = getText(xml, "URLBase");
+    const base = urlBase || descriptionUrl;
+
+    const services = {};
+    const svcRe = /<service>([\s\S]*?)<\/service>/g;
+    let m;
+    while ((m = svcRe.exec(xml)) !== null) {
+        const block = m[1];
+        const type = getText(block, "serviceType");
+        const ctrl = getText(block, "controlURL");
+        if (!type || !ctrl) continue;
+        const controlURL = new URL(ctrl, base).href;
+        // Match exact service ids; ":service:RenderingControl:" will not match "GroupRenderingControl".
+        if (/:service:AVTransport:\d/i.test(type) && !services.AVTransport) {
+            services.AVTransport = { type, controlURL };
+        } else if (/:service:RenderingControl:\d/i.test(type) && !services.RenderingControl) {
+            services.RenderingControl = { type, controlURL };
+        }
+    }
+    if (!services.AVTransport) throw new Error("AVTransport service not found in device description");
+    return services;
+}
+
+function soapAction(controlURL, serviceType, action, argsXml) {
+    const u = new URL(controlURL);
+    const body =
+        '<?xml version="1.0" encoding="utf-8"?>' +
+        '<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" s:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">' +
+        "<s:Body>" +
+        '<u:' + action + ' xmlns:u="' + serviceType + '">' + argsXml + "</u:" + action + ">" +
+        "</s:Body></s:Envelope>";
+    return httpRequest({
+        hostname: u.hostname,
+        port: u.port || 80,
+        path: u.pathname + u.search,
+        method: "POST",
+        timeout: 8000,
+        headers: {
+            "Content-Type": 'text/xml; charset="utf-8"',
+            "SOAPACTION": '"' + serviceType + "#" + action + '"',
+            "Content-Length": Buffer.byteLength(body)
+        }
+    }, body).then((res) => {
+        if (res.statusCode >= 400) {
+            const errCode = getText(res.body, "errorCode");
+            throw new Error("SOAP " + action + " failed: HTTP " + res.statusCode + (errCode ? " (UPnP error " + errCode + ")" : ""));
+        }
+        return res.body;
+    });
+}
+
+function buildDidl(url, contentType) {
+    const protocolInfo = "http-get:*:" + (contentType || "audio/mpeg") + ":*";
+    return (
+        '<DIDL-Lite xmlns="urn:schemas-upnp-org:metadata-1-0/DIDL-Lite/" ' +
+        'xmlns:dc="http://purl.org/dc/elements/1.1/" ' +
+        'xmlns:upnp="urn:schemas-upnp-org:metadata-1-0/upnp/">' +
+        '<item id="0" parentID="-1" restricted="1">' +
+        "<dc:title>TTS</dc:title>" +
+        "<upnp:class>object.item.audioItem.musicTrack</upnp:class>" +
+        '<res protocolInfo="' + protocolInfo + '">' + escapeXml(url) + "</res>" +
+        "</item></DIDL-Lite>"
+    );
+}
+
+// createPlayer(descriptionUrl) -> { setVolume, setAVTransportURI, play, getTransportState }
+function createPlayer(descriptionUrl) {
+    let servicesPromise = null;
+    const getServices = () => {
+        if (!servicesPromise) servicesPromise = resolveServices(descriptionUrl);
+        return servicesPromise;
+    };
+
+    return {
+        async setVolume(volume0to100) {
+            const svc = await getServices();
+            if (!svc.RenderingControl) return; // not all renderers expose volume control
+            const args =
+                "<InstanceID>0</InstanceID><Channel>Master</Channel>" +
+                "<DesiredVolume>" + Math.max(0, Math.min(100, Math.round(volume0to100))) + "</DesiredVolume>";
+            return soapAction(svc.RenderingControl.controlURL, svc.RenderingControl.type, "SetVolume", args);
+        },
+        async setAVTransportURI(url, contentType) {
+            const svc = await getServices();
+            const didl = buildDidl(url, contentType);
+            const args =
+                "<InstanceID>0</InstanceID>" +
+                "<CurrentURI>" + escapeXml(url) + "</CurrentURI>" +
+                "<CurrentURIMetaData>" + escapeXml(didl) + "</CurrentURIMetaData>";
+            return soapAction(svc.AVTransport.controlURL, svc.AVTransport.type, "SetAVTransportURI", args);
+        },
+        async play() {
+            const svc = await getServices();
+            return soapAction(svc.AVTransport.controlURL, svc.AVTransport.type, "Play", "<InstanceID>0</InstanceID><Speed>1</Speed>");
+        },
+        async getTransportState() {
+            const svc = await getServices();
+            const bodyXml = await soapAction(svc.AVTransport.controlURL, svc.AVTransport.type, "GetTransportInfo", "<InstanceID>0</InstanceID>");
+            return getText(bodyXml, "CurrentTransportState");
+        }
+    };
+}
+
+module.exports = { createPlayer, resolveServices };

package/ttsultimate/lib/googlecast-discovery.js

@@ -0,0 +1,69 @@
+// Discover Google Cast devices (Chromecast / Google Nest) on the local network
+// via mDNS / DNS-SD (service "_googlecast._tcp.local").
+const mdns = require("multicast-dns");
+
+const SERVICE = "_googlecast._tcp.local";
+
+// discoverCastDevices({ timeoutMs }) -> Promise<[{ name, host }]>
+function discoverCastDevices(options) {
+    const opts = options || {};
+    const timeoutMs = Number(opts.timeoutMs) || 4000;
+
+    return new Promise((resolve) => {
+        let socket;
+        try {
+            socket = mdns();
+        } catch (error) {
+            resolve([]);
+            return;
+        }
+
+        const srvByName = new Map(); // service instance name -> target hostname
+        const fnByName = new Map();  // service instance name -> friendly name (TXT "fn=")
+        const ipByHost = new Map();  // hostname -> IPv4 address
+
+        const handleRecords = (records) => {
+            (records || []).forEach((r) => {
+                if (!r || !r.name) return;
+                if (r.type === "SRV" && /_googlecast\._tcp/i.test(r.name) && r.data) {
+                    srvByName.set(r.name, r.data.target);
+                } else if (r.type === "TXT" && /_googlecast\._tcp/i.test(r.name)) {
+                    const arr = Array.isArray(r.data) ? r.data : [r.data];
+                    arr.forEach((entry) => {
+                        const s = (entry || "").toString();
+                        if (/^fn=/i.test(s)) fnByName.set(r.name, s.slice(3));
+                    });
+                } else if (r.type === "A" && r.data) {
+                    ipByHost.set(r.name, r.data);
+                }
+            });
+        };
+
+        socket.on("response", (response) => {
+            handleRecords(response.answers);
+            handleRecords(response.additionals);
+        });
+
+        const query = () => {
+            try { socket.query({ questions: [{ name: SERVICE, type: "PTR" }] }); } catch (e) { }
+        };
+        query();
+        setTimeout(query, 800);
+
+        setTimeout(() => {
+            try { socket.destroy(); } catch (e) { }
+            const devices = [];
+            const seenIp = new Set();
+            srvByName.forEach((target, name) => {
+                const ip = ipByHost.get(target);
+                if (!ip || seenIp.has(ip)) return;
+                seenIp.add(ip);
+                const fn = fnByName.get(name) || name.split(".")[0];
+                devices.push({ name: fn, host: ip });
+            });
+            resolve(devices);
+        }, timeoutMs);
+    });
+}
+
+module.exports = { discoverCastDevices };

package/ttsultimate/lib/googletranslate.js

@@ -0,0 +1,140 @@
+// Native Google Translate TTS implementation.
+// Replaces the external "google-translate-tts" dependency.
+// Exposes the same public API: { synthesize, voices }.
+//
+// It performs an unauthenticated POST to the Google Translate web endpoint
+// (the same one the translate.google.com page uses for the "listen" button)
+// and decodes the base64 MP3 audio from the response.
+const https = require("https");
+
+// ---------------------------------------------------------------------------
+// Voices supported by Google Translate (free, unauthenticated) TTS.
+// ---------------------------------------------------------------------------
+const voices = (() => {
+    // prettier-ignore
+    const list = [
+        { code: "af-ZA",       name: "Afrikaans" },
+        { code: "sq",          name: "Albanian" },
+        { code: "ar-AE",       name: "Arabic" },
+        { code: "hy",          name: "Armenian" },
+        { code: "bn-BD",       name: "Bengali (Bangladesh)" },
+        { code: "bn-IN",       name: "Bengali (India)" },
+        { code: "bs",          name: "Bosnian" },
+        { code: "my",          name: "Burmese (Myanmar)" },
+        { code: "ca-ES",       name: "Catalan" },
+        { code: "cmn-Hant-TW", name: "Chinese" },
+        { code: "hr-HR",       name: "Croatian" },
+        { code: "cs-CZ",       name: "Czech" },
+        { code: "da-DK",       name: "Danish" },
+        { code: "nl-NL",       name: "Dutch" },
+        { code: "en-AU",       name: "English (Australia)" },
+        { code: "en-GB",       name: "English (United Kingdom)" },
+        { code: "en-US",       name: "English (United States)" },
+        { code: "eo",          name: "Esperanto" },
+        { code: "et",          name: "Estonian" },
+        { code: "fil-PH",      name: "Filipino" },
+        { code: "fi-FI",       name: "Finnish" },
+        { code: "fr-FR",       name: "French" },
+        { code: "fr-CA",       name: "French (Canada)" },
+        { code: "de-DE",       name: "German" },
+        { code: "el-GR",       name: "Greek" },
+        { code: "gu",          name: "Gujarati" },
+        { code: "hi-IN",       name: "Hindi" },
+        { code: "hu-HU",       name: "Hungarian" },
+        { code: "is-IS",       name: "Icelandic" },
+        { code: "id-ID",       name: "Indonesian" },
+        { code: "it-IT",       name: "Italian" },
+        { code: "ja-JP",       name: "Japanese (Japan)" },
+        { code: "kn",          name: "Kannada" },
+        { code: "km",          name: "Khmer" },
+        { code: "ko-KR",       name: "Korean" },
+        { code: "la",          name: "Latin" },
+        { code: "lv",          name: "Latvian" },
+        { code: "mk",          name: "Macedonian" },
+        { code: "ml",          name: "Malayalam" },
+        { code: "mr",          name: "Marathi" },
+        { code: "ne",          name: "Nepali" },
+        { code: "nb-NO",       name: "Norwegian" },
+        { code: "pl-PL",       name: "Polish" },
+        { code: "pt-BR",       name: "Portuguese" },
+        { code: "ro-RO",       name: "Romanian" },
+        { code: "ru-RU",       name: "Russian" },
+        { code: "sr-RS",       name: "Serbian" },
+        { code: "si",          name: "Sinhala" },
+        { code: "sk-SK",       name: "Slovak" },
+        { code: "es-MX",       name: "Spanish (Mexico)" },
+        { code: "es-ES",       name: "Spanish (Spain)" },
+        { code: "sw",          name: "Swahili" },
+        { code: "sv-SE",       name: "Swedish" },
+        { code: "ta",          name: "Tamil" },
+        { code: "te",          name: "Telugu" },
+        { code: "th-TH",       name: "Thai" },
+        { code: "tr-TR",       name: "Turkish" },
+        { code: "uk-UA",       name: "Ukrainian" },
+        { code: "ur",          name: "Urdu" },
+        { code: "vi-VN",       name: "Vietnamese" },
+        { code: "cy",          name: "Welsh" }
+    ];
+
+    list.findByCode = (code) => list.find((l) => l.code === code);
+    list.findByName = (name) => list.find((l) => l.name === name);
+
+    return list;
+})();
+
+// ---------------------------------------------------------------------------
+// synthesize({ text, voice, slow }) -> Promise<Buffer> (MP3 audio)
+// ---------------------------------------------------------------------------
+const requestOptions = {
+    headers: {
+        "content-type": "application/x-www-form-urlencoded",
+    },
+    hostname: "translate.google.com",
+    method: "POST",
+    path: "/_/TranslateWebserverUi/data/batchexecute",
+};
+
+// Builds the urlencoded "f.req" body expected by the batchexecute endpoint.
+const buildBody = ({ slow = false, text, voice }) => {
+    const values = JSON.stringify([text, voice, slow ? true : null, "null"]);
+    const data = JSON.stringify([[["jQ1olc", values, null, "generic"]]]);
+    const params = new URLSearchParams({ "f.req": data });
+    return params.toString();
+};
+
+const httpRequest = (opts) =>
+    new Promise((resolve, reject) => {
+        const req = https.request(requestOptions, (res) => {
+            let data = "";
+            res.on("data", (chunk) => (data += chunk));
+            res.on("end", () => resolve(data));
+        });
+        req.on("error", reject);
+        req.write(buildBody(opts));
+        req.end();
+    });
+
+/* Response looks like:
+ *
+ *   )]}'
+ *
+ *   [["wrb.fr","jQ1olc","[\"<base 64 data>\"]"]]
+ *   ,["di",52]
+ *   ,["af.httprm",51,"8692744518077823928",2]
+ *   ]
+ */
+const toBuffer = (response) => {
+    const slice = response.split("\n").slice(1).join("");
+    const json = JSON.parse(slice);
+    const dataString = json[0][2];
+    const dataArray = JSON.parse(dataString);
+
+    if (dataArray === null)
+        throw new Error("Unable to parse audio data. Check your request params.");
+
+    return Buffer.from(dataArray[0], "base64");
+};
+
+const synthesize = (opts) => httpRequest(opts).then(toBuffer);
+
+module.exports = { synthesize, voices };

package/ttsultimate/ttsultimate-config copy.js

@@ -13,7 +13,7 @@ module.exports = function (RED) {
     // Setting up the engines
     const AWS = require('aws-sdk');
     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 microsoftAzureTTS = require("microsoft-cognitiveservices-speech-sdk"); // 12/10/2021
     const elevenlabsTTS = require("elevenlabs-node"); // 03/08/2023
     const ElevenLabsClient = require("elevenlabs").ElevenLabsClient;

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 = [];
@@ -680,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) { }
             }
 
         }

package/ttsultimate/ttsultimate.html

@@ -129,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">
@@ -150,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>
@@ -197,6 +220,17 @@
           required: false,
           type: "text"
         },
+        playeripaddress:
+        {
+          value: "",
+          required: false
+        },
+        playervolume:
+        {
+          value: "50",
+          required: false,
+          type: "text"
+        },
         sonoshailing:
         {
           value: "Hailing_Hailing.mp3",
@@ -302,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();
         });
         // ###########################
 
@@ -614,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>")
@@ -648,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);
@@ -719,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|
@@ -728,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|
@@ -754,6 +863,17 @@
 
 <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").

package/ttsultimate/ttsultimate.js

@@ -77,6 +77,8 @@ module.exports = function (RED) {
     node.currentMSGbeingSpoken = {}; // Stores the current message being spoken
     node.sonosCoordinatorPreviousVolumeSetByApp = 0; // 05/07/2021 stores the main payer volume set by the sonos app
     node.playertype = config.playertype === undefined ? "sonos" : config.playertype; // 20/09/2021 Player type
+    node.playeripaddress = (config.playeripaddress || "").trim(); // 06/2026 Chromecast/Nest IP or DLNA/UPnP renderer description XML URL
+    node.playervolume = config.playervolume === undefined ? "50" : config.playervolume; // 06/2026 Volume (0-100) for Google Cast / DLNA players
     node.speakingpitch = config.speakingpitch === undefined ? "0" : config.speakingpitch; // 21/09/2021 AudioConfig speakingpitch
     node.speakingrate = config.speakingrate === undefined ? "1" : config.speakingrate; // 21/09/2021 AudioConfig speakingrate
     node.unmuteIfMuted = config.unmuteIfMuted === undefined ? false : config.unmuteIfMuted; // 21/10/2021 Unmute if previiously muted.
@@ -422,7 +424,8 @@ module.exports = function (RED) {
       }
       // 27/11/2019 Start the connection healty check
       node.oTimerSonosConnectionCheck = setTimeout(function () { node.CheckSonosConnection(); }, 5000);
-    } else if (node.playertype === "noplayer") {
+    } else {
+      // 06/2026 noplayer, googlecast and dlna do not use the Sonos connection healthcheck.
       node.msg.connectionerror = false;
     }
 
@@ -530,7 +533,7 @@ module.exports = function (RED) {
       node.server.whoIsUsingTheServer = node.id; // Signal to other ttsultimate node, that i'm using the Sonos device
       try {
 
-        if (node.playertype !== "noplayer") {
+        if (node.playertype === "sonos") {
           // Get the current music queue, if one
           var oCurTrack = null;
           try {
@@ -909,6 +912,49 @@ module.exports = function (RED) {
                 node.setNodeStatus({ fill: 'red', shape: 'dot', text: 'Error ' + msg + " " + error.message });
               }
 
+            } else if (node.playertype === "googlecast" || node.playertype === "dlna") {
+
+              // 06/2026 Google Cast (Chromecast/Nest) and generic DLNA/UPnP renderers.
+              // Both just need the public HTTP URL of the file (same conversion as Sonos).
+              if (!node.sFileToBePlayed.toLowerCase().startsWith("http://") && !node.sFileToBePlayed.toLowerCase().startsWith("https://")) {
+                node.sFileToBePlayed = node.sNoderedURL + "/tts/tts.mp3?f=" + encodeURIComponent(node.sFileToBePlayed);
+              }
+
+              // Volume (0-100): a per-message volume overrides the configured one
+              let volTemp = node.currentMSGbeingSpoken.hasOwnProperty("volume") ? Number(node.currentMSGbeingSpoken.volume) : Number(node.playervolume);
+              if (isNaN(volTemp)) volTemp = 50;
+              if (volTemp < 0) volTemp = 0;
+              if (volTemp > 100) volTemp = 100;
+
+              node.setNodeStatus({ fill: 'green', shape: 'ring', text: 'Play ' + formatAudioSourceTag(audioSource) + msg });
+              try {
+                // Play on the main player + all additional players (reusing the Sonos additional
+                // players list), in parallel for multi-room playback. Works for Cast and DLNA.
+                const playFn = node.playertype === "googlecast" ? playGoogleCastSync : playDLNASync;
+                const targets = [{ host: node.playeripaddress, vol: volTemp }];
+                for (let ci = 0; ci < node.rules.length; ci++) {
+                  const r = node.rules[ci];
+                  if (r && r.host) {
+                    let v = volTemp + Number(r.hostVolumeAdjust || 0);
+                    if (isNaN(v)) v = volTemp;
+                    if (v < 0) v = 0;
+                    if (v > 100) v = 100;
+                    targets.push({ host: r.host, vol: v });
+                  }
+                }
+                const results = await Promise.allSettled(targets.map((t) => playFn(t.host, node.sFileToBePlayed, t.vol)));
+                const failures = results.filter((rr) => rr.status === "rejected");
+                if (failures.length === results.length) {
+                  throw new Error("all " + node.playertype + " targets failed: " + failures.map((f) => f.reason && f.reason.message).join("; "));
+                } else if (failures.length > 0) {
+                  RED.log.warn("ttsultimate: Some " + node.playertype + " targets failed: " + failures.map((f) => f.reason && f.reason.message).join("; "));
+                }
+                node.setNodeStatus({ fill: 'green', shape: 'ring', text: 'End playing ' + msg });
+              } catch (error) {
+                RED.log.error("ttsultimate: Error playing on " + node.playertype + " for " + node.sFileToBePlayed + " " + error.message);
+                node.setNodeStatus({ fill: 'red', shape: 'dot', text: 'Error ' + msg + " " + error.message });
+              }
+
             } else if (node.playertype === "noplayer") {
               // Output only the filename
               if (noPlayerFileArray === undefined || noPlayerFileArray === null) var noPlayerFileArray = [];
@@ -977,17 +1023,15 @@ module.exports = function (RED) {
             node.server.whoIsUsingTheServer = ""; // Signal to other ttsultimate node, that i'm not using the Sonos device anymore
           }, 500)
 
-        } else if (node.playertype === "noplayer") {
-          // End task if no player is selected.
-          // Output the array of files
+        } else {
+          // End task for noplayer, googlecast and dlna.
+          // For "noplayer" also output the array of generated files (undefined for the other types).
           // Signal end playing
-          //let t = setTimeout(() => {
           node.msg.completed = true;
           node.currentMSGbeingSpoken = {};
           node.send([{ passThroughMessage: node.passThroughMessage, payload: node.msg.completed, filesArray: noPlayerFileArray }, null]);
           node.bBusyPlayingQueue = false
           node.server.whoIsUsingTheServer = ""; // Signal to other ttsultimate node, that i'm not using the Sonos device anymore
-          //}, 1000)
         }
 
       } catch (error) {
@@ -1055,9 +1099,11 @@ module.exports = function (RED) {
       // 27/01/2021 Stop whatever in play.
       if (msg.hasOwnProperty("stop") && msg.stop === true) {
         node.flushQueue();
-        try {
-          STOPSync();
-        } catch (error) {
+        if (node.playertype === "sonos") {
+          try {
+            STOPSync().catch(() => { });
+          } catch (error) {
+          }
         }
         node.setNodeStatus({ fill: 'red', shape: 'ring', text: "Forced stop." });
         return;
@@ -1133,7 +1179,7 @@ module.exports = function (RED) {
           // There is already a priority message being spoken, do nothing
           node.setNodeStatus({ fill: 'grey', shape: 'ring', text: 'There is already a priority message being spoken...queuing' });
         } else {
-          if (node.playertype !== 'noplayer') {
+          if (node.playertype === 'sonos') {
             node.SonosClient.stop().then(result => {
               node.bTimeOutPlay = true;
               node.currentMSGbeingSpoken = msg; // Set immediately, otherwise if comes new flow messages, currentMSGbeingSpoken is too old.
@@ -1376,6 +1422,102 @@ module.exports = function (RED) {
       }
     }
 
+    // 06/2026 Google Cast (Chromecast / Google Nest) playback.
+    // Resolves when playback finishes (IDLE after PLAYING) or rejects on error/timeout.
+    function playGoogleCastSync(host, url, volume0to100) {
+      return new Promise((resolve, reject) => {
+        if (!host) { reject(new Error("Google Cast: no device IP address configured")); return; }
+        let CastClient, DefaultMediaReceiver;
+        try {
+          CastClient = require("castv2-client").Client;
+          DefaultMediaReceiver = require("castv2-client").DefaultMediaReceiver;
+        } catch (error) {
+          reject(new Error("castv2-client module not available: " + error.message));
+          return;
+        }
+        const client = new CastClient();
+        let settled = false;
+        const cleanup = () => { try { client.close(); } catch (e) { } };
+        const clearTimers = () => { clearTimeout(timeout); clearTimeout(startTimer); };
+        const fail = (err) => { if (settled) return; settled = true; clearTimers(); cleanup(); reject(err); };
+        const done = () => { if (settled) return; settled = true; clearTimers(); cleanup(); resolve(); };
+        const timeout = setTimeout(() => { fail(new Error("Google Cast: playback timeout")); }, 60000 * 10); // 10 minutes, like Sonos
+        // Fail fast if playback never starts (e.g. wrong IP on an unreachable/black-holed host).
+        const startTimer = setTimeout(() => { fail(new Error("Google Cast: device did not start playing within 45s (check IP/network)")); }, 45000);
+
+        client.on("error", (err) => fail(err));
+        client.connect(host, () => {
+          // Volume is 0..1 on Cast
+          try { client.setVolume({ level: Math.max(0, Math.min(1, volume0to100 / 100)) }, () => { }); } catch (e) { }
+          client.launch(DefaultMediaReceiver, (err, player) => {
+            if (err) { fail(err); return; }
+            let started = false;
+            player.on("status", (status) => {
+              if (!status) return;
+              if (status.playerState === "PLAYING") { started = true; clearTimeout(startTimer); }
+              // IDLE after playback started means the track has finished.
+              if (started && status.playerState === "IDLE") done();
+            });
+            const media = { contentId: url, contentType: "audio/mpeg", streamType: "BUFFERED" };
+            player.load(media, { autoplay: true }, (err2) => {
+              if (err2) fail(err2);
+            });
+          });
+        });
+      });
+    }
+
+    // 06/2026 Generic DLNA / UPnP media renderer playback.
+    // descriptionUrl is the renderer device description XML URL (e.g. http://192.168.1.50:1400/xml/device_description.xml).
+    // Uses a native client that finds the AVTransport/RenderingControl services anywhere in the
+    // device tree (so it also works with renderers that nest a MediaRenderer sub-device, e.g. Sonos).
+    // Resolves when playback finishes (STOPPED after PLAYING) or rejects on error/timeout.
+    function playDLNASync(descriptionUrl, url, volume0to100) {
+      return new Promise((resolve, reject) => {
+        if (!descriptionUrl) { reject(new Error("DLNA: no renderer description URL configured")); return; }
+        let dlnaPlayer;
+        try {
+          dlnaPlayer = require("./lib/dlna-player");
+        } catch (error) {
+          reject(new Error("dlna-player module not available: " + error.message));
+          return;
+        }
+        let settled = false;
+        const clearTimers = () => { clearTimeout(timeout); clearTimeout(startTimer); };
+        const fail = (err) => { if (settled) return; settled = true; clearTimers(); reject(err); };
+        const done = () => { if (settled) return; settled = true; clearTimers(); resolve(); };
+        const timeout = setTimeout(() => { fail(new Error("DLNA: playback timeout")); }, 60000 * 10); // 10 minutes, like Sonos
+        // Fail fast if playback never starts (e.g. wrong/unreachable renderer URL).
+        const startTimer = setTimeout(() => { fail(new Error("DLNA: renderer did not start playing within 45s (check description URL/network)")); }, 45000);
+
+        const player = dlnaPlayer.createPlayer(descriptionUrl);
+
+        (async () => {
+          try {
+            // Best-effort volume first (ignored by renderers without RenderingControl).
+            try { await player.setVolume(volume0to100); } catch (e) { }
+            await player.setAVTransportURI(url, "audio/mpeg");
+            await player.play();
+          } catch (error) {
+            fail(error);
+            return;
+          }
+          // Poll the transport state (UPnP eventing is not implemented by all renderers).
+          let started = false;
+          const poll = async () => {
+            if (settled) return;
+            let state = "";
+            try { state = await player.getTransportState(); } catch (e) { /* transient, keep polling */ }
+            if (settled) return;
+            if (state === "PLAYING" || state === "TRANSITIONING") { started = true; clearTimeout(startTimer); }
+            if (started && (state === "STOPPED" || state === "NO_MEDIA_PRESENT" || state === "PAUSED_PLAYBACK")) { done(); return; }
+            setTimeout(poll, 1000);
+          };
+          setTimeout(poll, 1000);
+        })();
+      });
+    }
+
     // 04/01/2021 hashing filename to avoid issues with long filenames.
     function getFilename(_text, _params) {
       let sTextToBeHashed = _text.concat(JSON.stringify(_params));