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

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

@@ -1,16 +1,35 @@
-![Sample Node](img/logo.png)
+<p align="center">
+  <img src="img/logo-v2.svg" alt="TTS Ultimate" width="700">
+</p>
+
+<p align="center">
+  <a href="https://npmjs.org/package/node-red-contrib-tts-ultimate"><img src="https://img.shields.io/npm/v/node-red-contrib-tts-ultimate.svg" alt="NPM version"></a>
+  <a href="https://npmjs.org/package/node-red-contrib-tts-ultimate"><img src="https://img.shields.io/npm/dm/node-red-contrib-tts-ultimate.svg" alt="NPM downloads per month"></a>
+  <a href="https://npmjs.org/package/node-red-contrib-tts-ultimate"><img src="https://img.shields.io/npm/dt/node-red-contrib-tts-ultimate.svg" alt="NPM downloads total"></a>
+  <a href="https://github.com/Supergiovane/node-red-contrib-tts-ultimate/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
+  <a href="https://standardjs.com"><img src="https://img.shields.io/badge/code_style-standard-brightgreen.svg" alt="JavaScript Standard Style"></a>
+  <a href="https://www.paypal.me/techtoday"><img src="https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square" alt="Donate via PayPal"></a>
+  <a href="https://www.facebook.com/supergiovaneDev"><img src="https://img.shields.io/badge/Visit%20me-Facebook-blue" alt="Visit me on Facebook"></a>
+</p>
+
+<p align="center">
+  <strong>Text-to-speech for Node-RED with Sonos, Google Cast, DLNA/UPnP and file-only output.</strong>
+</p>
 
-[![NPM version][npm-version-image]][npm-url]
-[![NPM downloads per month][npm-downloads-month-image]][npm-url]
-[![NPM downloads total][npm-downloads-total-image]][npm-url]
-[![MIT License][license-image]][license-url]
-[![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)
-[![Donate via PayPal](https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square)](https://www.paypal.me/techtoday)
-[![Facebook][facebook-image]][facebook-url]
+<p align="center">
+  <a href="#description">Description</a> ·
+  <a href="#supported-tts-engines">TTS engines</a> ·
+  <a href="#supported-players">Players</a> ·
+  <a href="#features">Features</a> ·
+  <a href="#tts-service-node">Configuration</a> ·
+  <a href="#ownfile-node-configuration">OwnFile</a>
+</p>
 
-<img src='https://raw.githubusercontent.com/Supergiovane/node-red-contrib-tts-ultimate/master/img/main.png' width="80%">
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-tts-ultimate/master/img/main.png" width="82%" alt="TTS Ultimate Node-RED flow">
+</p>
 
-<details><summary> VIEW SAMPLE CODE </summary>
+<details><summary><strong>VIEW SAMPLE FLOW CODE</strong></summary>
 
 > Adjust the nodes according to your setup
 
@@ -161,30 +180,95 @@
 
 ## 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/>
-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/>
-This is a major **_upgrade from the previously popular node SonosPollyTTS_** (SonosPollyTTS is not developed anymore).<br/>
+TTS Ultimate transforms text into speech audio from Node-RED. It can play announcements directly on **Sonos** speakers, **Google Cast** devices (Chromecast / Google Nest) and generic **DLNA/UPnP** renderers such as smart TVs and AV receivers.
 
-## SUPPORTED TTS ENGINES
+It can also work without any player: generate an audio file, cache it, and pass it to other nodes, web pages, Bluetooth workflows or third-party services. With the OwnFile node, you can upload and play your own audio messages and keep selected flows working completely offline.
 
-<p>
-  <a href="https://www.npmjs.com/package/google-translate-tts" title="Google Translate TTS (free)">
-    <img src="https://cdn.simpleicons.org/googletranslate/4285F4" height="126" alt="Google Translate logo"/>
-  </a>&nbsp;&nbsp;
-  <a href="https://cloud.google.com/text-to-speech" title="Google Cloud Text-to-Speech">
-    <img src="https://cdn.simpleicons.org/googlecloud/4285F4" height="126" alt="Google Cloud logo"/>
-  </a>&nbsp;&nbsp;
-  <a href="https://elevenlabs.io" title="ElevenLabs">
-    <img src="https://cdn.simpleicons.org/elevenlabs/000000" height="126" alt="ElevenLabs logo"/>
-  </a>&nbsp;&nbsp;
-  <a href="https://voice.ai/docs/api-reference/text-to-speech/generate-speech" title="Voice.ai">
-    <img src="https://voice.ai/favicon.ico" height="126" alt="Voice.ai logo"/>
-  </a>
-</p>
+This is a major upgrade from the previously popular **SonosPollyTTS** node, which is no longer developed.
+
+## SUPPORTED TTS ENGINES
 
-[![Donate via PayPal](https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square)](https://www.paypal.me/techtoday)
+<table>
+  <tr>
+    <td align="center" width="25%">
+      <a href="https://www.npmjs.com/package/google-translate-tts" title="Google Translate TTS (free)">
+        <img src="https://cdn.simpleicons.org/googletranslate/4285F4" height="86" alt="Google Translate logo"/>
+      </a>
+      <br/>
+      <strong>Google free TTS</strong>
+      <br/>
+      <sub>No credentials required</sub>
+    </td>
+    <td align="center" width="25%">
+      <a href="https://cloud.google.com/text-to-speech" title="Google Cloud Text-to-Speech">
+        <img src="https://cdn.simpleicons.org/googlecloud/4285F4" height="86" alt="Google Cloud logo"/>
+      </a>
+      <br/>
+      <strong>Google Cloud TTS</strong>
+      <br/>
+      <sub>Advanced voices and tuning</sub>
+    </td>
+    <td align="center" width="25%">
+      <a href="https://elevenlabs.io" title="ElevenLabs">
+        <img src="https://cdn.simpleicons.org/elevenlabs/000000" height="86" alt="ElevenLabs logo"/>
+      </a>
+      <br/>
+      <strong>ElevenLabs</strong>
+      <br/>
+      <sub>V1 and V2 multilingual voices</sub>
+    </td>
+    <td align="center" width="25%">
+      <a href="https://voice.ai/docs/api-reference/text-to-speech/generate-speech" title="Voice.ai">
+        <img src="https://voice.ai/favicon.ico" height="86" alt="Voice.ai logo"/>
+      </a>
+      <br/>
+      <strong>Voice.ai</strong>
+      <br/>
+      <sub>API key based voices</sub>
+    </td>
+  </tr>
+</table>
+
+## SUPPORTED PLAYERS
+
+<table>
+  <tr>
+    <td align="center" width="25%">
+      <a href="https://www.sonos.com" title="Sonos speakers">
+        <img src="https://cdn.simpleicons.org/sonos/000000" height="86" alt="Sonos logo"/>
+      </a>
+      <br/>
+      <strong>Sonos</strong>
+      <br/>
+      <sub>Native speakers and groups</sub>
+    </td>
+    <td align="center" width="25%">
+      <a href="https://developers.google.com/cast" title="Google Cast devices">
+        <img src="https://cdn.simpleicons.org/googlecast/4285F4" height="86" alt="Google Cast logo"/>
+      </a>
+      <br/>
+      <strong>Google Cast</strong>
+      <br/>
+      <sub>Chromecast and Google Nest</sub>
+    </td>
+    <td align="center" width="25%">
+      <a href="https://www.dlna.org" title="DLNA and UPnP renderers">
+        <img src="https://cdn.simpleicons.org/dlna/0066CC" height="86" alt="DLNA logo"/>
+      </a>
+      <br/>
+      <strong>DLNA / UPnP</strong>
+      <br/>
+      <sub>Smart TVs, AV receivers and renderers</sub>
+    </td>
+    <td align="center" width="25%">
+      <img src="img/audio-file.svg" height="86" alt="Audio file icon"/>
+      <br/>
+      <strong>No player</strong>
+      <br/>
+      <sub>Create an audio file only</sub>
+    </td>
+  </tr>
+</table>
 
 ## CHANGELOG
 
@@ -192,22 +276,22 @@ 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 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 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.
-- **UPLOAD your own audio files**. You can also upload your own audio files with OwnFile node.
-
-## BREAKING CHANGE !
-
-<p>
-<b>Version 3.0.0</b> April 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/>
-</p>
+- **Native Sonos support**: play TTS audio directly via Sonos, group speakers, set a hailing sound and choose the volume for each speaker.
+- **Google Cast support**: play announcements on Chromecast / Google Nest devices, including multi-room playback.
+- **DLNA / UPnP renderer support**: play TTS on smart TVs, AV receivers and other UPnP renderers. Renderers with nested MediaRenderer devices are supported too.
+- **File-only output**: create the TTS file without using any player, then pass it to other nodes or services.
+- **Multiple TTS engines**: Google free TTS, Google Cloud TTS, ElevenLabs and Voice.ai voices are supported.
+- **Automatic grouping / multi-room**: add additional players and play one announcement on several devices at once.
+- **Automatic discovery**: find Sonos and DLNA/UPnP renderers via SSDP, and Google Cast devices via mDNS.
+- **Music resume**: resume the previous queue after an announcement where supported. Some radio-station queues may not resume reliably because of Sonos API limitations.
+- **TTS caching**: generated audio is downloaded once and then served from cache. The cache survives reboots and updates.
+- **Offline-ready OwnFile playback**: upload custom audio messages and use them without an internet connection.
+
+## BREAKING CHANGE
+
+> **Version 3.0.0 - April 2025**
+>
+> Amazon Polly and Microsoft Azure TTS have been removed because the old APIs required a larger update. Contributions are welcome via fork and PR. If you still need those TTS engines, stay on or revert to `2.0.10`.
 
 ---
 
@@ -215,26 +299,26 @@ This is a major **_upgrade from the previously popular node SonosPollyTTS_** (So
 
 > **_NOTE IF YOU CANNOT UPLOAD YOUR OWN FILES_**
 >
-> If you're running node-red as "plugin" for homeassistant, redmatic etc...<br/>
-> You may expect not to be able to upload your own files. Please check that the user running node-red, has premission **to write to the filesystem**.<br/>
+> If you're running Node-RED as a plugin for Home Assistant, RedMatic, etc...<br/>
+> You may not be able to upload your own files. Please check that the user running Node-RED has permission **to write to the filesystem**.<br/>
 
 <br/><br/>
 
-# TTS Service node
+## 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/>
+PORTS USED BY THE NODE ARE 1980 (DEFAULT, HTTP FILE SERVER) AND 1400 (FOR SONOS DISCOVERY). <br/>
 PLEASE ALLOW MDNS AND UDP AS WELL
 
 **TTS Service**<br/>
-You can choose between Voice.ai, Elevenlabs.io, Google (without credentials), Google TTS (require credentials and registration to google).<br/>
+You can choose between Voice.ai, ElevenLabs.io, Google (without credentials), and Google TTS (requires credentials and registration with Google).<br/>
 For Google TTS Engine, you can choose pitch and speed rate of the voice.
 <br/>
 <br/>
 
 - **TTS Service using Google (without credentials)**<br/>
-  This is the simplest way. Just select the voice and you're done. You don't need any credential and you don't even need to be registered to any google service. The voice list is more limited than other services, but it works without hassles.
+  This is the simplest way. Just select the voice and you're done. You don't need any credential and you don't even need to be registered to any Google service. The voice list is more limited than other services, but it works without hassles.
   Note: long texts are automatically split into 200-character chunks (Google Translate TTS limit) and merged into a single audio output.
   Manual verify: `npm run verify:googletranslate-split -- --voice it-IT --text "..." --out ./out.mp3`
 
@@ -251,21 +335,21 @@ For Google TTS Engine, you can choose pitch and speed rate of the voice.
 <br/>
 
 - **TTS Service using ElevenLabs**<br/>
-  Please use the V2 engine, as the V1 is deprecated and will not longer be supported. The V2 has multilingual voices and is more powerful.  
-   You have two choiches: To register to eventlabs, or not to register. If you don't register to elevenlabs.io, you will either have access on a limited amount of voices, or no access at all.  
-   After registration at elevenlabs.io, you can add any language to your personal list. The personal list will be then show in the node voice's list.<br/>  
+  Please use the V2 engine, as the V1 is deprecated and will no longer be supported. The V2 has multilingual voices and is more powerful.<br/>
+   You have two choices: register to ElevenLabs, or do not register. If you don't register to ElevenLabs.io, you will either have access to a limited amount of voices, or no access at all.<br/>
+   After registration at ElevenLabs.io, you can add any language to your personal list. The personal list will then be shown in the node voice list.<br/>
   <br/>
 
 - **TTS Service using Voice.ai**<br/>
-  Add your Voice.ai API key in the config node, deploy and restart Node-RED. The node will load your available voices and show them in the Voice dropdown.  
+  Add your Voice.ai API key in the config node, deploy and restart Node-RED. The node will load your available voices and show them in the Voice dropdown.<br/>
    Note: SSML is not supported by this engine.
   <br/>
 
-**Node-Red IP**<br/>
-set IP of your node-red machine. Write **AUTODISCOVER** to allow the node to auto discover your IP.
+**Node-RED IP**<br/>
+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.
 
@@ -286,9 +370,9 @@ Leave this field blank for the default.<br/>
 <br/>
 <br/>
 
-# TTS-ULTIMATE NODE
+## TTS-Ultimate Node
 
-## INPUT MESSAGES TO THE NODE <br/>
+### INPUT MESSAGES TO THE NODE <br/>
 
 _Examples_
 
@@ -340,7 +424,7 @@ msg.stop = true;
 return msg;
 ```
 
-## CHANGE CONFIGURATION VIA MSG PROPERTY
+### CHANGE CONFIGURATION VIA MSG PROPERTY
 
 You can change the configuration of tts-ultimate, _via msg.setConfig_ property.<br/>
 The property is a JSON object.
@@ -502,7 +586,7 @@ return msg;
 <br/>
 <br/>
 
-# OWNFILE NODE CONFIGURATION
+## OwnFile Node Configuration
 
 <img src='https://github.com/Supergiovane/node-red-contrib-tts-ultimate/raw/master/img/of.png' width="80%">
 
@@ -620,7 +704,7 @@ return msg;
 
 </details>
 
-This node allow you to upload your custom message and play it via ttsultimate without the need of an internet connection. You can use it, for example, with your alarm panel, to annuce a zone breach, a doorbell or so.
+This node allows you to upload your custom message and play it via TTS Ultimate without the need for an internet connection. You can use it, for example, with your alarm panel to announce a zone breach, a doorbell or similar events.
 
 **Name**<br/>
 Node name
@@ -632,13 +716,13 @@ Select a file to be played. You can upload one or multiple files at the same tim
 If set to <b>true</b>, the OwnFile message will cancel the current TTS queue, will stop the current phrase being spoken and the TTS-Ultimate node will play this priority message.<br/>
 Please refer to _msg.priority_ msg input property of TTS-Ultimate for info on how this message will be handled<br/>
 
-## INPUT MESSAGE
+### INPUT MESSAGE
 
 **msg.payload = true**<br/>
 Begin play of the message <br/>
 
 **msg.selectedFile = "Garage door open"** <br/>
-Overrides the selected message and plays the filename you passed in. Please double check the spelling of the filename (must be the same as you can see in the dropdown list of your own files, in the node config window) and do not include the <b>.mp3</b> extenson.<br/>
+Overrides the selected message and plays the filename you passed in. Please double check the spelling of the filename (must be the same as you can see in the dropdown list of your own files, in the node config window) and do not include the <b>.mp3</b> extension.<br/>
 
 **msg.priority**<br/>
 If set to <b>true</b>, the OwnFile message will cancel the current TTS queue, will stop the current phrase being spoken and the TTS-Ultimate node will play this priority message.<br/>
@@ -647,7 +731,7 @@ Please refer to _msg.priority_ msg input property of TTS-Ultimate for info on ho
 ![Logo](https://raw.githubusercontent.com/Supergiovane/node-red-contrib-tts-ultimate/master/img/madeinitaly.png)
 
 [license-image]: https://img.shields.io/badge/license-MIT-blue.svg
-[license-url]: https://github.com/Supergiovane/node-red-contrib-tts-ultimate/master/LICENSE
+[license-url]: https://github.com/Supergiovane/node-red-contrib-tts-ultimate/blob/master/LICENSE
 [npm-url]: https://npmjs.org/package/node-red-contrib-tts-ultimate
 [npm-version-image]: https://img.shields.io/npm/v/node-red-contrib-tts-ultimate.svg
 [npm-downloads-month-image]: https://img.shields.io/npm/dm/node-red-contrib-tts-ultimate.svg

package/img/audio-file.svg

@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="128" height="128" viewBox="0 0 128 128" role="img" aria-labelledby="title desc">
+  <title id="title">Audio file</title>
+  <desc id="desc">A document with an audio waveform, representing output without a player.</desc>
+  <rect width="128" height="128" rx="18" fill="#f3f6fb"/>
+  <path d="M36 18h38l22 22v70H36z" fill="#ffffff" stroke="#1f2937" stroke-width="6" stroke-linejoin="round"/>
+  <path d="M74 18v24h22" fill="none" stroke="#1f2937" stroke-width="6" stroke-linejoin="round"/>
+  <path d="M48 72v-8m12 22V50m12 42V58m12 26V66" fill="none" stroke="#2563eb" stroke-width="8" stroke-linecap="round"/>
+</svg>

package/img/logo-v2.svg

@@ -0,0 +1,39 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="900" height="210" viewBox="0 0 900 210" role="img" aria-labelledby="title desc">
+  <title id="title">TTS Ultimate</title>
+  <desc id="desc">TTS Ultimate logo with a speech waveform mark and wordmark.</desc>
+  <defs>
+    <linearGradient id="markGradient" x1="16" y1="18" x2="172" y2="172" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#ffb3f0"/>
+      <stop offset="0.5" stop-color="#f47adf"/>
+      <stop offset="1" stop-color="#d84fc2"/>
+    </linearGradient>
+    <linearGradient id="textGradient" x1="218" y1="70" x2="620" y2="70" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#f56bdd"/>
+      <stop offset="0.55" stop-color="#e24ac8"/>
+      <stop offset="1" stop-color="#b932a8"/>
+    </linearGradient>
+    <filter id="softShadow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="0" dy="8" stdDeviation="9" flood-color="#172033" flood-opacity="0.16"/>
+    </filter>
+  </defs>
+
+  <rect x="10" y="10" width="880" height="190" rx="34" fill="#ffffff"/>
+  <rect x="10" y="10" width="880" height="190" rx="34" fill="none" stroke="#d9e1ef" stroke-width="2"/>
+
+  <g filter="url(#softShadow)">
+    <rect x="48" y="34" width="142" height="142" rx="36" fill="url(#markGradient)"/>
+    <path d="M78 106c15-24 36-36 61-36 18 0 33 6 46 18" fill="none" stroke="#ffffff" stroke-width="10" stroke-linecap="round"/>
+    <path d="M78 106c15 24 36 36 61 36 18 0 33-6 46-18" fill="none" stroke="#ffffff" stroke-width="10" stroke-linecap="round" opacity="0.92"/>
+    <path d="M86 108h12m15 18V90m17 54V72m17 62V82m17 38v-28" fill="none" stroke="#ffffff" stroke-width="8" stroke-linecap="round"/>
+    <circle cx="75" cy="106" r="8" fill="#ffffff"/>
+    <circle cx="186" cy="106" r="5" fill="#ffffff" opacity="0.8"/>
+  </g>
+
+  <g font-family="Inter, Avenir Next, Segoe UI, Arial, sans-serif">
+    <text x="220" y="100" fill="url(#textGradient)" font-size="62" font-weight="900" letter-spacing="3">TTS</text>
+    <text x="355" y="100" fill="#2a1830" font-size="62" font-weight="850" letter-spacing="2">ULTIMATE</text>
+    <text x="224" y="137" fill="#6f5574" font-size="24" font-weight="600" letter-spacing="1">NODE-RED TEXT TO SPEECH</text>
+    <path d="M224 153h312" stroke="url(#textGradient)" stroke-width="6" stroke-linecap="round"/>
+    <path d="M552 153h34" stroke="#ffb3f0" stroke-width="6" stroke-linecap="round"/>
+  </g>
+</svg>

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.1",
+  "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",

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 };