n8n-nodes-tts-bigboss 1.0.1 → 1.0.3

package/dist/TTSBigBoss.node.js

@@ -43,6 +43,34 @@ const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 const child_process = __importStar(require("child_process"));
 const ws_1 = __importDefault(require("ws"));
+const https = __importStar(require("https"));
+const stream = __importStar(require("stream"));
+const util_1 = require("util");
+const pipeline = (0, util_1.promisify)(stream.pipeline);
+const PIPER_MODELS = [
+    { name: 'Arabic (ar_JO) - Kareem (Low)', value: 'ar_JO-kareem-low' },
+    { name: 'Arabic (ar_JO) - Kareem (Medium)', value: 'ar_JO-kareem-medium' },
+    { name: 'English (US) - Lessac (Low)', value: 'en_US-lessac-low' },
+    { name: 'English (US) - Lessac (Medium)', value: 'en_US-lessac-medium' },
+    { name: 'English (US) - Lessac (High)', value: 'en_US-lessac-high' },
+    { name: 'English (US) - Ryan (Low)', value: 'en_US-ryan-low' },
+    { name: 'English (US) - Ryan (Medium)', value: 'en_US-ryan-medium' },
+    { name: 'English (US) - Ryan (High)', value: 'en_US-ryan-high' },
+    { name: 'English (US) - Amy (Low)', value: 'en_US-amy-low' },
+    { name: 'English (US) - Amy (Medium)', value: 'en_US-amy-medium' },
+    { name: 'English (US) - Kathleen (Low)', value: 'en_US-kathleen-low' },
+    { name: 'English (UK) - Alan (Low)', value: 'en_GB-alan-low' },
+    { name: 'English (UK) - Alan (Medium)', value: 'en_GB-alan-medium' },
+    { name: 'English (UK) - Southern English Female (Low)', value: 'en_GB-southern_english_female-low' },
+    { name: 'French (fr_FR) - Siwis (Low)', value: 'fr_FR-siwis-low' },
+    { name: 'French (fr_FR) - Siwis (Medium)', value: 'fr_FR-siwis-medium' },
+    { name: 'Spanish (es_ES) - Sharvard (Medium)', value: 'es_ES-sharvard-medium' },
+    { name: 'Spanish (es_MX) - Aldone (Medium)', value: 'es_MX-aldona-medium' },
+    { name: 'German (de_DE) - Eva (High)', value: 'de_DE-eva_k-x_low' },
+    { name: 'German (de_DE) - Thorsten (High)', value: 'de_DE-thorsten-high' },
+    { name: 'German (de_DE) - Thorsten (Medium)', value: 'de_DE-thorsten-medium' },
+    { name: 'German (de_DE) - Thorsten (Low)', value: 'de_DE-thorsten-low' },
+];
 const EDGE_URL = 'wss://speech.platform.bing.com/consumer/speech/synthesize/readaloud/edge/v1?TrustedClientToken=6A5AA1D4EAFF4E9FB37E23D68491D6F4';
 const EDGE_VOICES = [
     { name: 'Arabic (Egypt) - Salma', value: 'ar-EG-SalmaNeural' },
@@ -71,7 +99,7 @@ class TTSBigBoss {
             icon: 'fa:comment-dots',
             group: ['transform'],
             version: 1,
-            description: 'Advanced Text-to-Speech (Edge-TTS & System Clone)',
+            description: 'Advanced Text-to-Speech (Edge-TTS & Local Standalone)',
             defaults: {
                 name: 'TTS BigBoss',
             },
@@ -89,9 +117,14 @@ class TTSBigBoss {
                             description: 'High quality, multilingual, supports Arabic & perfect subtitles. Requires internet.',
                         },
                         {
-                            name: 'System Command (Local/Clone)',
+                            name: 'Local Piper (Auto-Download)',
+                            value: 'piper_local',
+                            description: 'Downloads and runs Piper locally (Offline). Good quality, fast.',
+                        },
+                        {
+                            name: 'System Command (Custom)',
                             value: 'system',
-                            description: 'Use locally installed tools (Piper, XTTS, Coqui) via command line.',
+                            description: 'Use custom command for installed tools (XTTS, etc).',
                         },
                     ],
                     default: 'edge',
@@ -174,8 +207,8 @@ class TTSBigBoss {
                     displayName: 'Command',
                     name: 'systemCommand',
                     type: 'string',
-                    default: 'piper --model en_US-lessac-medium --output_file "{output_file}"',
-                    description: 'Command to execute. Use placeholders: "{text}" for input text, "{output_file}" for the temporary audio path.',
+                    default: 'echo "Custom command here" > "{output_file}"',
+                    description: 'Command to execute. Use placeholders: "{text}", "{output_file}".',
                     displayOptions: {
                         show: {
                             engine: ['system'],
@@ -207,6 +240,36 @@ class TTSBigBoss {
                     },
                     description: 'Binary property name containing the reference audio for cloning. Use placeholder "{reference_audio}" in command.',
                 },
+                {
+                    displayName: 'Piper Voice Model',
+                    name: 'piperModel',
+                    type: 'options',
+                    options: [
+                        ...PIPER_MODELS,
+                        { name: 'Custom (Enter URL)', value: 'custom' },
+                    ],
+                    default: 'en_US-lessac-medium',
+                    displayOptions: {
+                        show: {
+                            engine: ['piper_local'],
+                        },
+                    },
+                    description: 'Select a voice model. It will be downloaded automatically on first use.',
+                },
+                {
+                    displayName: 'Custom Model Name/URL',
+                    name: 'piperModelCustom',
+                    type: 'string',
+                    default: '',
+                    placeholder: 'e.g. en_US-bryce-medium',
+                    displayOptions: {
+                        show: {
+                            engine: ['piper_local'],
+                            piperModel: ['custom'],
+                        },
+                    },
+                    description: 'Name from Hugging Face (e.g. en_US-bryce-medium) or full URL to .onnx file.',
+                },
             ],
         };
     }
@@ -214,6 +277,10 @@ class TTSBigBoss {
         const items = this.getInputData();
         const returnData = [];
         const tempDir = os.tmpdir();
+        const binDir = path.join(path.dirname(__dirname), 'bin');
+        if (!fs.existsSync(binDir)) {
+            fs.mkdirSync(binDir, { recursive: true });
+        }
         for (let i = 0; i < items.length; i++) {
             try {
                 const engine = this.getNodeParameter('engine', i);
@@ -231,7 +298,48 @@ class TTSBigBoss {
                     const pitch = this.getNodeParameter('edgePitch', i);
                     const result = await runEdgeTTS(text, voice, rate, pitch);
                     audioBuffer = result.audio;
-                    srtBuffer = Buffer.from(result.srt, 'utf8');
+                    if (!result.srt || result.srt.trim().length === 0) {
+                        srtBuffer = Buffer.from(generateHeuristicSRT(text, result.audio.length), 'utf8');
+                    }
+                    else {
+                        srtBuffer = Buffer.from(result.srt, 'utf8');
+                    }
+                }
+                else if (engine === 'piper_local') {
+                    let piperModel = this.getNodeParameter('piperModel', i);
+                    if (piperModel === 'custom') {
+                        piperModel = this.getNodeParameter('piperModelCustom', i);
+                    }
+                    const piperBinPath = await ensurePiperBinary(binDir);
+                    const { modelPath, configPath } = await ensurePiperModel(binDir, piperModel);
+                    const outFile = path.join(tempDir, `piper_out_${(0, uuid_1.v4)()}.wav`);
+                    await new Promise((resolve, reject) => {
+                        const piperProc = child_process.spawn(piperBinPath, [
+                            '--model', modelPath,
+                            '--config', configPath,
+                            '--output_file', outFile
+                        ]);
+                        piperProc.stdin.write(text);
+                        piperProc.stdin.end();
+                        let errData = '';
+                        piperProc.stderr.on('data', (d) => errData += d.toString());
+                        piperProc.on('close', (code) => {
+                            if (code === 0)
+                                resolve();
+                            if (errData.includes('json.exception.parse_error')) {
+                                reject(new Error(`Piper Config Error: The downloaded JSON configuration for model '${piperModel}' seems corrupted (HTML instead of JSON?). Try deleting the file at ${configPath} and running again.`));
+                            }
+                            else {
+                                reject(new Error(`Piper failed (exit ${code}): ${errData}`));
+                            }
+                        });
+                        piperProc.on('error', (err) => reject(err));
+                    });
+                    if (!fs.existsSync(outFile))
+                        throw new Error('Piper did not produce output file');
+                    audioBuffer = fs.readFileSync(outFile);
+                    srtBuffer = Buffer.from(generateHeuristicSRT(text, audioBuffer.length), 'utf8');
+                    fs.unlinkSync(outFile);
                 }
                 else {
                     const commandTpl = this.getNodeParameter('systemCommand', i);
@@ -320,36 +428,35 @@ async function runEdgeTTS(text, voice, rate, pitch) {
         });
         ws.on('message', (data, isBinary) => {
             const textData = data.toString();
-            if (textData.includes('Path:turn.start')) {
-            }
-            else if (textData.includes('Path:turn.end')) {
-                ws.close();
-                const fullAudio = Buffer.concat(audioChunks);
-                const srt = buildSRT(wordBoundaries);
-                resolve({ audio: fullAudio, srt });
-            }
-            else if (textData.includes('Path:audio.metadata')) {
-                try {
-                    const parts = textData.split('\r\n\r\n');
-                    if (parts.length > 1) {
-                        const json = JSON.parse(parts[1]);
-                        if (json.Metadata && Array.isArray(json.Metadata)) {
-                            for (const meta of json.Metadata) {
-                                if (meta.Type === 'Word') {
-                                    wordBoundaries.push({
-                                        offset: meta.Offset,
-                                        duration: meta.Duration,
-                                        text: meta.Text,
-                                    });
+            if (textData.includes('Path:audio.metadata')) {
+                const parts = textData.split(/\r\n\r\n/);
+                for (const part of parts) {
+                    try {
+                        if (part.trim().startsWith('{')) {
+                            const json = JSON.parse(part);
+                            if (json.Metadata && Array.isArray(json.Metadata)) {
+                                for (const meta of json.Metadata) {
+                                    if (meta.Type === 'Word') {
+                                        wordBoundaries.push({
+                                            offset: meta.Offset,
+                                            duration: meta.Duration,
+                                            text: meta.Text,
+                                        });
+                                    }
                                 }
                             }
                         }
                     }
-                }
-                catch (e) {
+                    catch (e) { }
                 }
             }
-            else if (isBinary || (data.length > 2 && data[0] === 0x00 && data[1] === 0x67)) {
+            if (textData.includes('Path:turn.end')) {
+                ws.close();
+                const fullAudio = Buffer.concat(audioChunks);
+                const srt = buildSRT(wordBoundaries);
+                resolve({ audio: fullAudio, srt });
+            }
+            if (isBinary || (data.length > 2 && data[0] === 0x00 && data[1] === 0x67)) {
                 const headerLen = data.readUInt16BE(0);
                 if (data.length > headerLen + 2) {
                     const audioData = data.slice(headerLen + 2);
@@ -363,6 +470,8 @@ async function runEdgeTTS(text, voice, rate, pitch) {
     });
 }
 function buildSRT(words) {
+    if (!words || words.length === 0)
+        return '';
     let srt = '';
     let counter = 1;
     let currentPhrase = [];
@@ -421,3 +530,106 @@ function generateHeuristicSRT(text, byteLength) {
     }
     return srt;
 }
+async function ensurePiperBinary(binDir) {
+    const platform = os.platform();
+    const arch = os.arch();
+    let binaryName = 'piper';
+    if (platform === 'win32')
+        binaryName = 'piper.exe';
+    const finalPath = path.join(binDir, binaryName);
+    if (fs.existsSync(finalPath))
+        return finalPath;
+    let url = '';
+    let archiveName = '';
+    if (platform === 'linux' && arch === 'x64') {
+        url = 'https://github.com/rhasspy/piper/releases/download/2023.11.14-2/piper_linux_x86_64.tar.gz';
+        archiveName = 'piper.tar.gz';
+    }
+    else if (platform === 'win32' && arch === 'x64') {
+        url = 'https://github.com/rhasspy/piper/releases/download/2023.11.14-2/piper_windows_amd64.zip';
+        archiveName = 'piper.zip';
+    }
+    else {
+        throw new Error(`Auto-download for Piper not supported on ${platform} ${arch}. Please install manually.`);
+    }
+    const archivePath = path.join(binDir, archiveName);
+    console.log(`Downloading Piper from ${url}...`);
+    await downloadFile(url, archivePath);
+    try {
+        if (platform === 'win32') {
+            child_process.execSync(`powershell -command "Expand-Archive -Path '${archivePath}' -DestinationPath '${binDir}' -Force"`);
+            const extractedFolder = path.join(binDir, 'piper');
+            return path.join(binDir, 'piper', 'piper.exe');
+        }
+        else {
+            child_process.execSync(`tar -xzf "${archivePath}" -C "${binDir}"`);
+            return path.join(binDir, 'piper', 'piper');
+        }
+    }
+    catch (e) {
+        throw new Error(`Failed to extract Piper: ${e.message}`);
+    }
+}
+async function ensurePiperModel(binDir, modelNameOrUrl) {
+    let modelUrl = '';
+    let modelFilename = '';
+    if (modelNameOrUrl.startsWith('http')) {
+        modelUrl = modelNameOrUrl;
+        modelFilename = path.basename(modelNameOrUrl);
+    }
+    else {
+        const parts = modelNameOrUrl.split('-');
+        if (parts.length >= 3) {
+            const langRegion = parts[0] + '_' + parts[1];
+            const voice = parts[2];
+            const quality = parts[3] || 'medium';
+            const lang = parts[0];
+            modelFilename = modelNameOrUrl + '.onnx';
+            modelUrl = `https://huggingface.co/rhasspy/piper-voices/resolve/main/${lang}/${langRegion}/${voice}/${quality}/${modelFilename}?download=true`;
+        }
+        else {
+            throw new Error(`Invalid model name format: ${modelNameOrUrl}. Use format lang_REGION-voice-quality`);
+        }
+    }
+    const modelPath = path.join(binDir, modelFilename);
+    const configPath = modelPath + '.json';
+    if (!fs.existsSync(modelPath) || fs.statSync(modelPath).size < 1000) {
+        console.log(`Downloading Piper Model: ${modelUrl}`);
+        await downloadFile(modelUrl, modelPath);
+    }
+    if (!fs.existsSync(configPath) || fs.statSync(configPath).size < 10) {
+        const configUrl = modelUrl + '.json';
+        console.log(`Downloading Piper Config: ${configUrl}`);
+        await downloadFile(configUrl, configPath);
+        try {
+            const content = fs.readFileSync(configPath, 'utf8');
+            JSON.parse(content);
+        }
+        catch (e) {
+            fs.unlinkSync(configPath);
+            if (fs.existsSync(modelPath))
+                fs.unlinkSync(modelPath);
+            throw new Error(`Downloaded config for ${modelNameOrUrl} was not valid JSON. URL might be wrong: ${configUrl}. Content start: ${fs.readFileSync(configPath, 'utf8').substring(0, 50)}...`);
+        }
+    }
+    return { modelPath, configPath };
+}
+async function downloadFile(url, dest) {
+    return new Promise((resolve, reject) => {
+        const file = fs.createWriteStream(dest);
+        https.get(url, (response) => {
+            if (response.statusCode === 302 || response.statusCode === 301) {
+                downloadFile(response.headers.location, dest).then(resolve).catch(reject);
+                return;
+            }
+            response.pipe(file);
+            file.on('finish', () => {
+                file.close();
+                resolve();
+            });
+        }).on('error', (err) => {
+            fs.unlink(dest, () => { });
+            reject(err);
+        });
+    });
+}

package/nodes/TTSBigBoss/TTSBigBoss.node.ts

@@ -10,6 +10,49 @@ import * as path from 'path';
 import * as os from 'os';
 import * as child_process from 'child_process';
 import WebSocket from 'ws';
+import * as https from 'https';
+import * as stream from 'stream';
+import { promisify } from 'util';
+import * as zlib from 'zlib'; // For extracting .tar.gz if needed, typically usage of tar command is easier on linux
+
+const pipeline = promisify(stream.pipeline);
+
+// Piper Models List (Curated High Quality)
+const PIPER_MODELS = [
+    // Arabic
+    { name: 'Arabic (ar_JO) - Kareem (Low)', value: 'ar_JO-kareem-low' },
+    { name: 'Arabic (ar_JO) - Kareem (Medium)', value: 'ar_JO-kareem-medium' },
+
+    // English (US)
+    { name: 'English (US) - Lessac (Low)', value: 'en_US-lessac-low' },
+    { name: 'English (US) - Lessac (Medium)', value: 'en_US-lessac-medium' },
+    { name: 'English (US) - Lessac (High)', value: 'en_US-lessac-high' },
+    { name: 'English (US) - Ryan (Low)', value: 'en_US-ryan-low' },
+    { name: 'English (US) - Ryan (Medium)', value: 'en_US-ryan-medium' },
+    { name: 'English (US) - Ryan (High)', value: 'en_US-ryan-high' },
+    { name: 'English (US) - Amy (Low)', value: 'en_US-amy-low' },
+    { name: 'English (US) - Amy (Medium)', value: 'en_US-amy-medium' },
+    { name: 'English (US) - Kathleen (Low)', value: 'en_US-kathleen-low' },
+
+    // English (UK)
+    { name: 'English (UK) - Alan (Low)', value: 'en_GB-alan-low' },
+    { name: 'English (UK) - Alan (Medium)', value: 'en_GB-alan-medium' },
+    { name: 'English (UK) - Southern English Female (Low)', value: 'en_GB-southern_english_female-low' },
+
+    // French
+    { name: 'French (fr_FR) - Siwis (Low)', value: 'fr_FR-siwis-low' },
+    { name: 'French (fr_FR) - Siwis (Medium)', value: 'fr_FR-siwis-medium' },
+
+    // Spanish
+    { name: 'Spanish (es_ES) - Sharvard (Medium)', value: 'es_ES-sharvard-medium' },
+    { name: 'Spanish (es_MX) - Aldone (Medium)', value: 'es_MX-aldona-medium' },
+
+    // German
+    { name: 'German (de_DE) - Eva (High)', value: 'de_DE-eva_k-x_low' }, // mapped to available
+    { name: 'German (de_DE) - Thorsten (High)', value: 'de_DE-thorsten-high' },
+    { name: 'German (de_DE) - Thorsten (Medium)', value: 'de_DE-thorsten-medium' },
+    { name: 'German (de_DE) - Thorsten (Low)', value: 'de_DE-thorsten-low' },
+];
 
 // Edge TTS Constants
 const EDGE_URL = 'wss://speech.platform.bing.com/consumer/speech/synthesize/readaloud/edge/v1?TrustedClientToken=6A5AA1D4EAFF4E9FB37E23D68491D6F4';
@@ -52,7 +95,7 @@ export class TTSBigBoss implements INodeType {
         icon: 'fa:comment-dots',
         group: ['transform'],
         version: 1,
-        description: 'Advanced Text-to-Speech (Edge-TTS & System Clone)',
+        description: 'Advanced Text-to-Speech (Edge-TTS & Local Standalone)',
         defaults: {
             name: 'TTS BigBoss',
         },
@@ -70,9 +113,14 @@ export class TTSBigBoss implements INodeType {
                         description: 'High quality, multilingual, supports Arabic & perfect subtitles. Requires internet.',
                     },
                     {
-                        name: 'System Command (Local/Clone)',
+                        name: 'Local Piper (Auto-Download)',
+                        value: 'piper_local',
+                        description: 'Downloads and runs Piper locally (Offline). Good quality, fast.',
+                    },
+                    {
+                        name: 'System Command (Custom)',
                         value: 'system',
-                        description: 'Use locally installed tools (Piper, XTTS, Coqui) via command line.',
+                        description: 'Use custom command for installed tools (XTTS, etc).',
                     },
                 ],
                 default: 'edge',
@@ -164,8 +212,8 @@ export class TTSBigBoss implements INodeType {
                 displayName: 'Command',
                 name: 'systemCommand',
                 type: 'string',
-                default: 'piper --model en_US-lessac-medium --output_file "{output_file}"',
-                description: 'Command to execute. Use placeholders: "{text}" for input text, "{output_file}" for the temporary audio path.',
+                default: 'echo "Custom command here" > "{output_file}"',
+                description: 'Command to execute. Use placeholders: "{text}", "{output_file}".',
                 displayOptions: {
                     show: {
                         engine: ['system'],
@@ -197,6 +245,39 @@ export class TTSBigBoss implements INodeType {
                 },
                 description: 'Binary property name containing the reference audio for cloning. Use placeholder "{reference_audio}" in command.',
             },
+            // ----------------------------------
+            // Local Piper Settings
+            // ----------------------------------
+            {
+                displayName: 'Piper Voice Model',
+                name: 'piperModel',
+                type: 'options',
+                options: [
+                    ...PIPER_MODELS,
+                    { name: 'Custom (Enter URL)', value: 'custom' },
+                ],
+                default: 'en_US-lessac-medium',
+                displayOptions: {
+                    show: {
+                        engine: ['piper_local'],
+                    },
+                },
+                description: 'Select a voice model. It will be downloaded automatically on first use.',
+            },
+            {
+                displayName: 'Custom Model Name/URL',
+                name: 'piperModelCustom',
+                type: 'string',
+                default: '',
+                placeholder: 'e.g. en_US-bryce-medium',
+                displayOptions: {
+                    show: {
+                        engine: ['piper_local'],
+                        piperModel: ['custom'],
+                    },
+                },
+                description: 'Name from Hugging Face (e.g. en_US-bryce-medium) or full URL to .onnx file.',
+            },
         ],
     };
 
@@ -205,6 +286,12 @@ export class TTSBigBoss implements INodeType {
         const returnData: INodeExecutionData[] = [];
         const tempDir = os.tmpdir();
 
+        // Ensure bin directory exists for local tools
+        const binDir = path.join(path.dirname(__dirname), 'bin'); // ../bin from nodes/TTSBigBoss/
+        if (!fs.existsSync(binDir)) {
+            fs.mkdirSync(binDir, { recursive: true });
+        }
+
         for (let i = 0; i < items.length; i++) {
             try {
                 const engine = this.getNodeParameter('engine', i) as string;
@@ -228,7 +315,65 @@ export class TTSBigBoss implements INodeType {
 
                     const result = await runEdgeTTS(text, voice, rate, pitch);
                     audioBuffer = result.audio;
-                    srtBuffer = Buffer.from(result.srt, 'utf8');
+                    // Fallback if SRT empty
+                    if (!result.srt || result.srt.trim().length === 0) {
+                        srtBuffer = Buffer.from(generateHeuristicSRT(text, result.audio.length), 'utf8');
+                    } else {
+                        srtBuffer = Buffer.from(result.srt, 'utf8');
+                    }
+
+                } else if (engine === 'piper_local') {
+                    // ----------------------------------
+                    // PIPER LOCAL AUTOMATION
+                    // ----------------------------------
+                    let piperModel = this.getNodeParameter('piperModel', i) as string;
+                    if (piperModel === 'custom') {
+                        piperModel = this.getNodeParameter('piperModelCustom', i) as string;
+                    }
+
+                    // 1. Ensure Piper Binary
+                    const piperBinPath = await ensurePiperBinary(binDir);
+
+                    // 2. Ensure Voice Model
+                    const { modelPath, configPath } = await ensurePiperModel(binDir, piperModel);
+
+                    // 3. Execute
+                    const outFile = path.join(tempDir, `piper_out_${uuidv4()}.wav`);
+                    // Piper command: echo "text" | piper --model model.onnx --output_file out.wav
+                    // We use child_process.spawn to pipe text safely
+
+                    await new Promise<void>((resolve, reject) => {
+                        const piperProc = child_process.spawn(piperBinPath, [
+                            '--model', modelPath,
+                            '--config', configPath,
+                            '--output_file', outFile
+                        ]);
+
+                        piperProc.stdin.write(text);
+                        piperProc.stdin.end();
+
+                        let errData = '';
+                        piperProc.stderr.on('data', (d) => errData += d.toString());
+
+                        piperProc.on('close', (code) => {
+                            if (code === 0) resolve();
+                            // Check for the specific JSON error in stderr
+                            if (errData.includes('json.exception.parse_error')) {
+                                reject(new Error(`Piper Config Error: The downloaded JSON configuration for model '${piperModel}' seems corrupted (HTML instead of JSON?). Try deleting the file at ${configPath} and running again.`));
+                            } else {
+                                reject(new Error(`Piper failed (exit ${code}): ${errData}`));
+                            }
+                        });
+
+                        piperProc.on('error', (err) => reject(err));
+                    });
+
+                    if (!fs.existsSync(outFile)) throw new Error('Piper did not produce output file');
+
+                    audioBuffer = fs.readFileSync(outFile);
+                    srtBuffer = Buffer.from(generateHeuristicSRT(text, audioBuffer.length), 'utf8');
+
+                    fs.unlinkSync(outFile);
 
                 } else {
                     // ----------------------------------
@@ -353,47 +498,45 @@ async function runEdgeTTS(text: string, voice: string, rate: string, pitch: stri
         });
 
         ws.on('message', (data: Buffer, isBinary: boolean) => {
+            // Try to interpret as text first
             const textData = data.toString();
 
-            if (textData.includes('Path:turn.start')) {
-                // Start of turn
-            } else if (textData.includes('Path:turn.end')) {
-                // End of turn - Finish
-                ws.close();
-                const fullAudio = Buffer.concat(audioChunks);
-                const srt = buildSRT(wordBoundaries);
-                resolve({ audio: fullAudio, srt });
-            } else if (textData.includes('Path:audio.metadata')) {
+            if (textData.includes('Path:audio.metadata')) {
                 // Parse Metadata (Word Boundaries)
-                try {
-                    const parts = textData.split('\r\n\r\n');
-                    if (parts.length > 1) {
-                        const json = JSON.parse(parts[1]);
-                        if (json.Metadata && Array.isArray(json.Metadata)) {
-                            for (const meta of json.Metadata) {
-                                if (meta.Type === 'Word') {
-                                    wordBoundaries.push({
-                                        offset: meta.Offset, // 100ns units
-                                        duration: meta.Duration,
-                                        text: meta.Text,
-                                    });
+                // Markers might be interleaved with header, need robust split
+                const parts = textData.split(/\r\n\r\n/);
+                // iterate to find JSON
+                for (const part of parts) {
+                    try {
+                        // Look for JSON object start
+                        if (part.trim().startsWith('{')) {
+                            const json = JSON.parse(part);
+                            if (json.Metadata && Array.isArray(json.Metadata)) {
+                                for (const meta of json.Metadata) {
+                                    if (meta.Type === 'Word') {
+                                        wordBoundaries.push({
+                                            offset: meta.Offset, // 100ns units
+                                            duration: meta.Duration,
+                                            text: meta.Text,
+                                        });
+                                    }
                                 }
                             }
                         }
-                    }
-                } catch (e) {
-                    // Ignore parse errors
+                    } catch (e) { /* ignore non-json parts */ }
                 }
-            } else if (isBinary || (data.length > 2 && data[0] === 0x00 && data[1] === 0x67)) {
-                // Binary Audio Data
-                // The header is usually 2 bytes + requestID length + timestamp. 
-                // Edge TTS binary format: Header length (2B) + Header + Audio Data
-                // We need to strip the header to get clean MP3.
-                // Header format: "X-RequestId:...\r\nPath:audio\r\n..."
-
-                // Simple Strip: Look for "Path:audio\r\n\r\n" in the buffer?
-                // Binary messages have a specific binary header structure.
-                // Structure: 2 bytes (header length) + Header Text + Data
+            }
+
+            if (textData.includes('Path:turn.end')) {
+                // End of turn - Finish
+                ws.close();
+                const fullAudio = Buffer.concat(audioChunks);
+                const srt = buildSRT(wordBoundaries);
+                resolve({ audio: fullAudio, srt });
+            }
+
+            if (isBinary || (data.length > 2 && data[0] === 0x00 && data[1] === 0x67)) {
+                // Binary Audio Data (header 2 bytes length + content)
                 const headerLen = data.readUInt16BE(0);
                 if (data.length > headerLen + 2) {
                     const audioData = data.slice(headerLen + 2);
@@ -409,6 +552,7 @@ async function runEdgeTTS(text: string, voice: string, rate: string, pitch: stri
 }
 
 function buildSRT(words: WordBoundary[]): string {
+    if (!words || words.length === 0) return '';
     let srt = '';
     let counter = 1;
     // Group words into reasonable chunks if they are close? 
@@ -503,3 +647,142 @@ function generateHeuristicSRT(text: string, byteLength: number): string {
 
     return srt;
 }
+
+// --------------------------------------------------------------------------
+// PIPER DOWNLOADER HELPERS
+// --------------------------------------------------------------------------
+async function ensurePiperBinary(binDir: string): Promise<string> {
+    // 1. Check Platform
+    const platform = os.platform(); // linux, darwin, win32
+    const arch = os.arch(); // x64, arm64
+
+    let binaryName = 'piper';
+    if (platform === 'win32') binaryName = 'piper.exe';
+
+    const finalPath = path.join(binDir, binaryName);
+    if (fs.existsSync(finalPath)) return finalPath;
+
+    // 2. Determine Download URL (Latest release 2023.11.14-2)
+    // https://github.com/rhasspy/piper/releases/download/2023.11.14-2/piper_linux_x86_64.tar.gz
+    // https://github.com/rhasspy/piper/releases/download/2023.11.14-2/piper_windows_amd64.zip
+
+    let url = '';
+    let archiveName = '';
+
+    if (platform === 'linux' && arch === 'x64') {
+        url = 'https://github.com/rhasspy/piper/releases/download/2023.11.14-2/piper_linux_x86_64.tar.gz';
+        archiveName = 'piper.tar.gz';
+    } else if (platform === 'win32' && arch === 'x64') {
+        url = 'https://github.com/rhasspy/piper/releases/download/2023.11.14-2/piper_windows_amd64.zip';
+        archiveName = 'piper.zip';
+    } else {
+        throw new Error(`Auto-download for Piper not supported on ${platform} ${arch}. Please install manually.`);
+    }
+
+    const archivePath = path.join(binDir, archiveName);
+
+    // Download
+    console.log(`Downloading Piper from ${url}...`);
+    await downloadFile(url, archivePath);
+
+    // Extract (Simple approach: use system tar/unzip if available)
+    // Since user environment is likely Linux (n8n docker) or Windows.
+    try {
+        if (platform === 'win32') {
+            child_process.execSync(`powershell -command "Expand-Archive -Path '${archivePath}' -DestinationPath '${binDir}' -Force"`);
+            const extractedFolder = path.join(binDir, 'piper'); // Zip contains 'piper' folder
+            // Move piper.exe to binDir root or return piper/piper.exe
+            // The zip contains a 'piper' folder.
+            return path.join(binDir, 'piper', 'piper.exe');
+        } else {
+            child_process.execSync(`tar -xzf "${archivePath}" -C "${binDir}"`);
+            return path.join(binDir, 'piper', 'piper'); // Tar contains 'piper' folder
+        }
+    } catch (e) {
+        throw new Error(`Failed to extract Piper: ${e.message}`);
+    }
+}
+
+async function ensurePiperModel(binDir: string, modelNameOrUrl: string): Promise<{ modelPath: string, configPath: string }> {
+    // Heuristic for HF URL construction
+    // https://huggingface.co/rhasspy/piper-voices/resolve/main/[lang_code]/[region]/[voice]/[quality]/[filename]
+    // Example: en_US-lessac-medium -> en/en_US/lessac/medium/en_US-lessac-medium.onnx
+
+    let modelUrl = '';
+    let modelFilename = '';
+
+    if (modelNameOrUrl.startsWith('http')) {
+        modelUrl = modelNameOrUrl;
+        modelFilename = path.basename(modelNameOrUrl);
+    } else {
+        // Construct URL from name
+        const parts = modelNameOrUrl.split('-');
+        if (parts.length >= 3) {
+            const langRegion = parts[0] + '_' + parts[1]; // en_US
+            const voice = parts[2];
+            const quality = parts[3] || 'medium';
+            const lang = parts[0]; // en
+
+            // e.g. en_US-lessac-medium
+            // lang=en, region=en_US, voice=lessac, quality=medium
+            // url path: en/en_US/lessac/medium/en_US-lessac-medium.onnx
+
+            // Handle special case: ar_JO (no lang folder? check repo)
+            // Generally structure is: lang_short/lang_long/voice/quality/filename
+
+            modelFilename = modelNameOrUrl + '.onnx';
+            modelUrl = `https://huggingface.co/rhasspy/piper-voices/resolve/main/${lang}/${langRegion}/${voice}/${quality}/${modelFilename}?download=true`; // Add download=true to force direct link
+        } else {
+            throw new Error(`Invalid model name format: ${modelNameOrUrl}. Use format lang_REGION-voice-quality`);
+        }
+    }
+
+    const modelPath = path.join(binDir, modelFilename);
+    const configPath = modelPath + '.json';
+
+    // Download if missing or seems incomplete (size < 1KB)
+    if (!fs.existsSync(modelPath) || fs.statSync(modelPath).size < 1000) {
+        console.log(`Downloading Piper Model: ${modelUrl}`);
+        await downloadFile(modelUrl, modelPath);
+    }
+
+    // Download config if missing or seems incomplete (size < 10 bytes)
+    if (!fs.existsSync(configPath) || fs.statSync(configPath).size < 10) {
+        const configUrl = modelUrl + '.json';
+        console.log(`Downloading Piper Config: ${configUrl}`);
+        await downloadFile(configUrl, configPath);
+
+        // Validate JSON
+        try {
+            const content = fs.readFileSync(configPath, 'utf8');
+            JSON.parse(content);
+        } catch (e) {
+            fs.unlinkSync(configPath); // Delete bad file
+            if (fs.existsSync(modelPath)) fs.unlinkSync(modelPath); // Delete model too as it might be bad
+            throw new Error(`Downloaded config for ${modelNameOrUrl} was not valid JSON. URL might be wrong: ${configUrl}. Content start: ${fs.readFileSync(configPath, 'utf8').substring(0, 50)}...`);
+        }
+    }
+
+    return { modelPath, configPath };
+}
+
+async function downloadFile(url: string, dest: string): Promise<void> {
+    return new Promise((resolve, reject) => {
+        const file = fs.createWriteStream(dest);
+        https.get(url, (response) => {
+            if (response.statusCode === 302 || response.statusCode === 301) {
+                // Follow redirect
+                downloadFile(response.headers.location!, dest).then(resolve).catch(reject);
+                return;
+            }
+            response.pipe(file);
+            file.on('finish', () => {
+                file.close();
+                resolve();
+            });
+        }).on('error', (err) => {
+            fs.unlink(dest, () => { });
+            reject(err);
+        });
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-tts-bigboss",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "BigBoss TTS node with multi-engine support and automatic SRT generation",
   "keywords": [
     "n8n-community-node-package",