echogarden 0.11.22 → 0.12.0

package/dist/utilities/PackageManager.js

@@ -1,7 +1,7 @@
-import path from "node:path";
-import { downloadAndExtractTarball } from "./FileDownloader.js";
-import { getAppDataDir, getAppTempDir, ensureDir, existsSync, remove } from "./FileSystem.js";
-import { appName } from "../api/Common.js";
+import path from 'node:path';
+import { downloadAndExtractTarball } from './FileDownloader.js';
+import { getAppDataDir, getAppTempDir, ensureDir, existsSync, remove } from './FileSystem.js';
+import { appName } from '../api/Common.js';
 export async function loadPackage(packageName) {
     packageName = resolveToVersionedPackageNameIfNeeded(packageName);
     const packagesPath = await ensureAndGetPackagesDir();
@@ -26,7 +26,7 @@ export async function removePackage(packageName) {
 }
 export async function ensureAndGetPackagesDir() {
     const dataPath = getAppDataDir(appName);
-    const packagesPath = path.join(dataPath, "packages");
+    const packagesPath = path.join(dataPath, 'packages');
     await ensureDir(packagesPath);
     return packagesPath;
 }
@@ -44,39 +44,61 @@ export function getVersionTagFromPackageName(packageName) {
 export function resolveVersionTagForUnversionedPackageName(unversionedPackageName) {
     return packageVersionTagResolutionLookup[unversionedPackageName] || defaultVersionTag;
 }
-const basePackageUrl = "https://huggingface.co/echogarden/echogarden-packages/resolve/main/";
-const defaultVersionTag = "20230718";
+const basePackageUrl = 'https://huggingface.co/echogarden/echogarden-packages/resolve/main/';
+const defaultVersionTag = '20230718';
 const packageVersionTagResolutionLookup = {
-    "sox-14.4.2-linux-minimal": "20230802",
-    "vits-de_DE-thorsten_emotional-medium": "20230808",
-    "vits-en_GB-semaine-medium": "20230808",
-    "vits-fr_FR-upmc-medium": "20230808",
-    "vits-lb_LU-marylux-medium": "20230808",
-    "vits-ro_RO-mihai-medium": "20230808",
-    "vits-sr_RS-serbski_institut-medium": "20230808",
-    "vits-tr_TR-dfki-medium": "20230808",
-    "vits-cs_CZ-jirka-medium": "20230824",
-    "vits-de_DE-thorsten-high": "20230824",
-    "vits-hu_HU-anna-medium": "20230824",
-    "vits-pt_PT-tugao-medium": "20230824",
-    "vits-sk_SK-lili-medium": "20230824",
-    "vits-tr_TR-fahrettin-medium": "20230824",
-    "vits-ar_JO-kareem-medium": "20231022",
-    "vits-cs_CZ-jirka-low": "20231022",
-    "vits-en_US-hfc_male-medium": "20231022",
-    "vits-en_US-libritts_r-medium": "20231022",
-    "vits-hu_HU-imre-medium": "20231022",
-    "vits-pl_PL-mc_speech-medium": "20231022",
-    "whisper-tiny": "20231126",
-    "whisper-tiny.en": "20231126",
-    "whisper-base": "20231126",
-    "whisper-base.en": "20231126",
-    "whisper-small": "20231126",
-    "whisper-small.en": "20231126",
-    "whisper-medium": "20231126",
-    "whisper-medium.en": "20231126",
-    "whisper-large-v3": "20231126",
-    "vits-ar_JO-kareem-low": "20231126",
-    "vits-en_US-hfc_female-medium": "20231126",
+    'sox-14.4.2-linux-minimal': '20230802',
+    'vits-de_DE-thorsten_emotional-medium': '20230808',
+    'vits-en_GB-semaine-medium': '20230808',
+    'vits-fr_FR-upmc-medium': '20230808',
+    'vits-lb_LU-marylux-medium': '20230808',
+    'vits-ro_RO-mihai-medium': '20230808',
+    'vits-sr_RS-serbski_institut-medium': '20230808',
+    'vits-tr_TR-dfki-medium': '20230808',
+    'vits-cs_CZ-jirka-medium': '20230824',
+    'vits-de_DE-thorsten-high': '20230824',
+    'vits-hu_HU-anna-medium': '20230824',
+    'vits-pt_PT-tugao-medium': '20230824',
+    'vits-sk_SK-lili-medium': '20230824',
+    'vits-tr_TR-fahrettin-medium': '20230824',
+    'vits-ar_JO-kareem-medium': '20231022',
+    'vits-cs_CZ-jirka-low': '20231022',
+    'vits-en_US-hfc_male-medium': '20231022',
+    'vits-en_US-libritts_r-medium': '20231022',
+    'vits-hu_HU-imre-medium': '20231022',
+    'vits-pl_PL-mc_speech-medium': '20231022',
+    'whisper-tiny': '20231126',
+    'whisper-tiny.en': '20231126',
+    'whisper-base': '20231126',
+    'whisper-base.en': '20231126',
+    'whisper-small': '20231126',
+    'whisper-small.en': '20231126',
+    'whisper-medium': '20231126',
+    'whisper-medium.en': '20231126',
+    'whisper-large-v3': '20231126',
+    'vits-ar_JO-kareem-low': '20231126',
+    'vits-en_US-hfc_female-medium': '20231126',
+    'ffmpeg-6.0-win32-x64': '20240316',
+    'ffmpeg-6.0-win32-ia32': '20240316',
+    'ffmpeg-6.0-darwin-x64': '20240316',
+    'ffmpeg-6.0-darwin-arm64': '20240316',
+    'ffmpeg-6.0-linux-x64': '20240316',
+    'ffmpeg-6.0-linux-ia32': '20240316',
+    'ffmpeg-6.0-linux-arm64': '20240316',
+    'ffmpeg-6.0-linux-arm': '20240316',
+    'ffmpeg-6.0-freebsd-x64': '20240316',
+    'vits-de_DE-mls-medium': '20240316',
+    'vits-en_GB-cori-high': '20240316',
+    'vits-en_US-kristin-medium': '20240316',
+    'vits-en_US-ljspeech-high': '20240316',
+    'vits-en_US-ljspeech-medium': '20240316',
+    'vits-es_MX-claude-high': '20240316',
+    'vits-fa_IR-amir-medium': '20240316',
+    'vits-fa_IR-gyro-medium': '20240316',
+    'vits-fr_FR-mls-medium': '20240316',
+    'vits-fr_FR-tom-medium': '20240316',
+    'vits-nl_NL-mls-medium': '20240316',
+    'vits-sl_SI-artur-medium': '20240316',
+    'vits-tr_TR-fettah-medium': '20240316',
 };
 //# sourceMappingURL=PackageManager.js.map

package/dist/utilities/PackageManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"PackageManager.js","sourceRoot":"","sources":["../../src/utilities/PackageManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PackageManager.js","sourceRoot":"","sources":["../../src/utilities/PackageManager.ts"],"names":[],"mappings":"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"}

package/docs/API.md

@@ -248,6 +248,31 @@ Converts subtitles to a timeline.
 
 Timeline object.
 
+## Global options
+
+### `setGlobalOption(key, value)`
+
+Set a global option.
+
+Supported keys:
+
+* `'ffmpegPath'`: override FFMpeg executable path
+* `'soxPath'`: override SoX executable path
+
+### `getGlobalOption(key)`
+
+Get a global option.
+
+Supported keys:
+
+* `'ffmpegPath'`: get FFMpeg executable path
+* `'soxPath'`: get SoX executable path
+
+#### Returns:
+
+The value associated with the given key.
+
 ## TODO
 
 Expose more methods that may be useful for developers, like phonemization, etc.
+

package/docs/Engines.md

@@ -4,7 +4,7 @@
 ## Text to speech
 
 **Offline**:
-* [VITS](https://github.com/jaywalnut310/vits) (`vits`): a high-quality end-to-end neural speech synthesis architecture. Available models were trained by Michael Hansen as part of his [Piper speech synthesis system](https://github.com/rhasspy/piper). Currently there are 104 voices, in a range of languages, including English (US, UK), Spanish (ES, MX), Portuguese (PT, BR), Italian, French, German, Dutch (NL, BE), Swedish, Norwegian, Danish, Finnish, Polish, Greek, Romanian, Serbian, Czech, Hungarian, Slovak, Turkish, Arabic, Russian, Ukrainian, Catalan, Luxemburgish, Icelandic, Swahili, Kazakh, Georgian, Nepali, Vietnamese and Chinese. You can listen to audio samples of all voices and languages in [Piper's samples page](https://rhasspy.github.io/piper-samples/).
+* [VITS](https://github.com/jaywalnut310/vits) (`vits`): a high-quality end-to-end neural speech synthesis architecture. Available models were trained by Michael Hansen as part of his [Piper speech synthesis system](https://github.com/rhasspy/piper). Currently there are 117 voices, in a range of languages, including English (US, UK), Spanish (ES, MX), Portuguese (PT, BR), Italian, French, German, Dutch (NL, BE), Swedish, Norwegian, Danish, Finnish, Polish, Greek, Romanian, Serbian, Czech, Hungarian, Slovak, Slovenian, Turkish, Arabic, Farsi, Russian, Ukrainian, Catalan, Luxemburgish, Icelandic, Swahili, Kazakh, Georgian, Nepali, Vietnamese and Chinese. You can listen to audio samples of all voices and languages in [Piper's samples page](https://rhasspy.github.io/piper-samples/).
 * [SVOX Pico](https://github.com/naggety/picotts) (`pico`): a legacy diphone-based synthesis engine. Supports English (US, UK), Spanish, Italian, French, and German.
 * [Flite](https://github.com/festvox/flite) (`flite`): a legacy diphone-based synthesis engine. Supports English (US, Scottish), and several Indic languages: Hindi, Bengali, Marathi, Telugu, Tamil, Gujarati, Kannada and Punjabi.
 * [eSpeak-NG](https://github.com/espeak-ng/espeak-ng/) (`espeak`): a lightweight "robot" sounding formant-based synthesizer. Supports 100+ languages. Extensively used internally for speech alignment, phonemization, and other internal tasks.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "echogarden",
-	"version": "0.11.22",
+	"version": "0.12.0",
 	"description": "An integrated speech toolset, providing a variety of synthesis, recognition, alignment, and other processing tools, designed to be directly accessible to end-users.",
 	"author": "Rotem Dan",
 	"license": "GPL-3.0",
@@ -54,8 +54,8 @@
 		"echogarden": "./dist/cli/CLILauncher.js"
 	},
 	"dependencies": {
-		"@aws-sdk/client-polly": "^3.529.1",
-		"@aws-sdk/client-transcribe-streaming": "^3.529.1",
+		"@aws-sdk/client-polly": "^3.535.0",
+		"@aws-sdk/client-transcribe-streaming": "^3.535.0",
 		"@echogarden/espeak-ng-emscripten": "^0.1.2",
 		"@echogarden/fasttext-wasm": "^0.1.0",
 		"@echogarden/flite-wasi": "^0.1.1",
@@ -121,12 +121,12 @@
 		"@types/msgpack-lite": "^0.1.11",
 		"@types/ndarray": "^1.0.14",
 		"@types/ndarray-ops": "^1.2.7",
-		"@types/node": "^20.11.25",
+		"@types/node": "^20.11.28",
 		"@types/recursive-readdir": "^2.2.4",
 		"@types/tar": "^6.1.11",
 		"@types/ws": "^8.5.10",
-		"@typescript-eslint/eslint-plugin": "^7.1.1",
-		"@typescript-eslint/parser": "^7.1.1",
+		"@typescript-eslint/eslint-plugin": "^7.2.0",
+		"@typescript-eslint/parser": "^7.2.0",
 		"eslint": "^8.57.0",
 		"ts-json-schema-generator": "^1.5.0",
 		"typescript": "^5.4.2"

package/src/api/API.ts

@@ -1,6 +1,7 @@
 /// <reference path="../typings/Fillers.d.ts" />
 
 export * from "./Common.js"
+export * from "./GlobalOptions.js"
 export * from "./Synthesis.js"
 export * from "./Recognition.js"
 export * from "./Alignment.js"

package/src/api/GlobalOptions.ts

@@ -0,0 +1,25 @@
+export function getGlobalOption<K extends keyof GlobalOptions>(key: K): GlobalOptions[K] {
+	if (!Object.keys(globalOptions).includes(key)) {
+		throw new Error(`Unknown global option key '${key}'`)
+	}
+
+	return globalOptions[key]
+}
+
+export function setGlobalOption<K extends keyof GlobalOptions>(key: K, value: GlobalOptions[K]) {
+	if (!Object.keys(globalOptions).includes(key)) {
+		throw new Error(`Unknown global option key '${key}'`)
+	}
+
+	globalOptions[key] = value as any
+}
+
+export interface GlobalOptions {
+	ffmpegPath?: string
+	soxPath?: string
+}
+
+const globalOptions = {
+	ffmpegPath: undefined,
+	soxPath: undefined
+}

package/src/audio/AudioUtilities.ts

@@ -42,12 +42,12 @@ export function trimAudioEnd(audioSamples: Float32Array, targetEndSilentSampleCo
 }
 
 export function getStartingSilentSampleCount(audioSamples: Float32Array, amplitudeThresholdDecibels = defaultSilenceThresholdDecibels) {
-	const minSampleValue = decibelsToGain(amplitudeThresholdDecibels)
+	const minSampleAmplitude = decibelsToGainFactor(amplitudeThresholdDecibels)
 
 	let silentSampleCount = 0
 
 	for (let i = 0; i < audioSamples.length - 1; i++) {
-		if (Math.abs(audioSamples[i]) > minSampleValue) {
+		if (Math.abs(audioSamples[i]) > minSampleAmplitude) {
 			break
 		}
 
@@ -58,12 +58,12 @@ export function getStartingSilentSampleCount(audioSamples: Float32Array, amplitu
 }
 
 export function getEndingSilentSampleCount(audioSamples: Float32Array, amplitudeThresholdDecibels = defaultSilenceThresholdDecibels) {
-	const minSampleValue = decibelsToGain(amplitudeThresholdDecibels)
+	const minSampleAmplitude = decibelsToGainFactor(amplitudeThresholdDecibels)
 
 	let silentSampleCount = 0
 
 	for (let i = audioSamples.length - 1; i >= 0; i--) {
-		if (Math.abs(audioSamples[i]) > minSampleValue) {
+		if (Math.abs(audioSamples[i]) > minSampleAmplitude) {
 			break
 		}
 
@@ -83,14 +83,14 @@ export function downmixToMonoAndNormalize(rawAudio: RawAudio, targetPeakDb = -3)
 export function normalizeAudioLevel(rawAudio: RawAudio, targetPeakDb = -3, maxIncreaseDb = 30): RawAudio {
 	//rawAudio = correctDCBias(rawAudio)
 
-	const targetPeakSampleValue = decibelsToGain(targetPeakDb)
-	const maxMultiplier = decibelsToGain(maxIncreaseDb)
+	const targetPeakAmplitude = decibelsToGainFactor(targetPeakDb)
+	const maxGainFactor = decibelsToGainFactor(maxIncreaseDb)
 
-	const maxAbsoluteSampleValue = getAudioPeakGain(rawAudio.audioChannels)
+	const peakAmplitude = getAudioPeakAmplitude(rawAudio.audioChannels)
 
-	const multiplier = Math.min(targetPeakSampleValue / maxAbsoluteSampleValue, maxMultiplier)
+	const gainFactor = Math.min(targetPeakAmplitude / peakAmplitude, maxGainFactor)
 
-	return applyGain(rawAudio, multiplier)
+	return applyGain(rawAudio, gainFactor)
 }
 
 export function correctDCBias(rawAudio: RawAudio): RawAudio {
@@ -120,21 +120,19 @@ export function correctDCBias(rawAudio: RawAudio): RawAudio {
 }
 
 export function applyGainDecibels(rawAudio: RawAudio, decibelGain: number): RawAudio {
-	return applyGain(rawAudio, decibelsToGain(decibelGain))
+	return applyGain(rawAudio, decibelsToGainFactor(decibelGain))
 }
 
-export function applyGain(rawAudio: RawAudio, gain: number): RawAudio {
+export function applyGain(rawAudio: RawAudio, gainFactor: number): RawAudio {
 	const outputAudioChannels: Float32Array[] = []
 
-	const multiplier = gain
-
 	for (const channelSamples of rawAudio.audioChannels) {
 		const sampleCount = channelSamples.length
 
 		const outputChannelSamples = new Float32Array(sampleCount)
 
 		for (let i = 0; i < sampleCount; i++) {
-			outputChannelSamples[i] = channelSamples[i] * multiplier
+			outputChannelSamples[i] = channelSamples[i] * gainFactor
 		}
 
 		outputAudioChannels.push(outputChannelSamples)
@@ -158,19 +156,19 @@ export function downmixToMono(rawAudio: RawAudio): RawAudio {
 }
 
 export function getAudioPeakDecibels(audioChannels: Float32Array[]) {
-	return gainToDecibels(getAudioPeakGain(audioChannels))
+	return gainFactorToDecibels(getAudioPeakAmplitude(audioChannels))
 }
 
-export function getAudioPeakGain(audioChannels: Float32Array[]) {
-	let maxAbsoluteSampleValue = 0.00001
+export function getAudioPeakAmplitude(audioChannels: Float32Array[]) {
+	let maxAmplitude = 0.00001
 
 	for (const channelSamples of audioChannels) {
 		for (const sample of channelSamples) {
-			maxAbsoluteSampleValue = Math.max(maxAbsoluteSampleValue, Math.abs(sample))
+			maxAmplitude = Math.max(maxAmplitude, Math.abs(sample))
 		}
 	}
 
-	return maxAbsoluteSampleValue
+	return maxAmplitude
 }
 
 export function mixAudio(rawAudio1: RawAudio, rawAudio2: RawAudio) {
@@ -252,7 +250,7 @@ export function fadeAudioInOut(rawAudio: RawAudio, fadeTime: number): RawAudio {
 	const fadeSampleCount = Math.floor(rawAudio.sampleRate * fadeTime)
 	const gainReductionPerFrameDecibels = -60 / fadeSampleCount
 
-	const gainReductionPerFrameMultiplier = decibelsToGain(gainReductionPerFrameDecibels)
+	const gainReductionPerFrameFactor = decibelsToGainFactor(gainReductionPerFrameDecibels)
 
 	const outAudioChannels = rawAudio.audioChannels.map(channel => channel.slice())
 
@@ -261,18 +259,20 @@ export function fadeAudioInOut(rawAudio: RawAudio, fadeTime: number): RawAudio {
 			continue
 		}
 
-		let multiplier = 1.0
+		let factor = 1.0
 
 		for (let i = fadeSampleCount - 1; i >= 0; i--) {
-			channel[i] *= multiplier
-			multiplier *= gainReductionPerFrameMultiplier
+			channel[i] *= factor
+
+			factor *= gainReductionPerFrameFactor
 		}
 
-		multiplier = 1.0
+		factor = 1.0
 
 		for (let i = channel.length - fadeSampleCount; i < channel.length; i++) {
-			channel[i] *= multiplier
-			multiplier *= gainReductionPerFrameMultiplier
+			channel[i] *= factor
+
+			factor *= gainReductionPerFrameFactor
 		}
 	}
 
@@ -352,11 +352,11 @@ export async function ensureRawAudio(input: AudioSourceParam, outSampleRate?: nu
 // Unit conversion
 ////////////////////////////////////////////////////////////////////////////////////////////////
 
-export function gainToDecibels(gain: number) {
-	return gain <= 0.00001 ? -100 : (20.0 * Math.log10(gain))
+export function gainFactorToDecibels(gainFactor: number) {
+	return gainFactor <= 0.00001 ? -100 : (20.0 * Math.log10(gainFactor))
 }
 
-export function decibelsToGain(decibels: number) {
+export function decibelsToGainFactor(decibels: number) {
 	return decibels <= -100.0 ? 0 : Math.pow(10, 0.05 * decibels)
 }
 

package/src/audio/SoxPath.ts

@@ -1,24 +1,31 @@
-import path from "path"
-import { loadPackage } from "../utilities/PackageManager.js"
-import { commandExists } from "../utilities/Utilities.js"
+import path from 'path'
+import { loadPackage } from '../utilities/PackageManager.js'
+import { commandExists } from '../utilities/Utilities.js'
+import { getGlobalOption } from '../api/GlobalOptions.js'
 
 export async function tryResolvingSoxPath() {
-	let soxPath: string | undefined = undefined
+	if (getGlobalOption('soxPath')) {
+		return getGlobalOption('soxPath')
+	}
+
+	const platform = process.platform
+	const arch = process.arch
 
-	if (process.platform == "win32") {
-		const soxPackagePath = await loadPackage("sox-14.4.1a-win32")
-		soxPath = path.join(soxPackagePath, "sox.exe")
+	if (platform === 'win32') {
+		const soxPackagePath = await loadPackage('sox-14.4.1a-win32')
+
+		return path.join(soxPackagePath, 'sox.exe')
 	}
-	/*else if (process.platform == "darwin" && process.arch == "x64") {
-		const soxPackagePath = await loadPackage("sox-14.4.1-macosx")
-		soxPath = path.join(soxPackagePath, "sox")
-	} */
-	else if (process.platform == "linux" && process.arch == "x64") {
-		const soxPackagePath = await loadPackage("sox-14.4.2-linux-minimal")
-		soxPath = path.join(soxPackagePath, "sox")
-	} else if (await commandExists("sox")) {
-		soxPath = "sox"
+
+	if (await commandExists('sox')) {
+		return 'sox'
+	}
+
+	if (platform === 'linux' && arch === 'x64') {
+		const soxPackagePath = await loadPackage('sox-14.4.2-linux-minimal')
+
+		return path.join(soxPackagePath, 'sox')
 	}
 
-	return soxPath
+	return undefined
 }

package/src/codecs/FFMpegTranscoder.ts

@@ -6,6 +6,7 @@ import { Logger } from "../utilities/Logger.js"
 import { commandExists, logToStderr } from "../utilities/Utilities.js"
 import path from "node:path"
 import { loadPackage } from "../utilities/PackageManager.js"
+import { getGlobalOption } from "../api/GlobalOptions.js"
 
 const log = logToStderr
 
@@ -147,25 +148,53 @@ function buildCommandLineArguments(inputFilename: string, outputOptions: FFMpegO
 }
 
 async function getFFMpegExecutablePath() {
-	if (process.platform == "win32") {
-		const ffmpegPackagePath = await loadPackage("ffmpeg-6.0-essentials-win64")
-
-		return path.join(ffmpegPackagePath, "ffmpeg.exe")
+	// If a global option set for the path, use it
+	if (getGlobalOption('ffmpegPath')) {
+		return getGlobalOption('ffmpegPath')
+	}
+
+	// If an 'ffmpeg' command exist in system path, use it
+	if (await commandExists('ffmpeg')) {
+		return 'ffmpeg'
+	}
+
+	// Otherwise, download and use an internal ffmpeg package
+	const platform = process.platform
+	const arch = process.arch
+
+	let packageName: string
+
+	if (platform === 'win32' && arch === 'x64') {
+		packageName = 'ffmpeg-6.0-win32-x64'
+	} else if (platform === 'win32' && arch === 'ia32') {
+		packageName = 'ffmpeg-6.0-win32-ia32'
+	} else if (platform === 'darwin' && arch === 'x64') {
+		packageName = 'ffmpeg-6.0-darwin-x64'
+	} else if (platform === 'darwin' && arch === 'arm64') {
+		packageName = 'ffmpeg-6.0-darwin-arm64'
+	} else if (platform === 'linux' && arch === 'x64') {
+		packageName = 'ffmpeg-6.0-linux-x64'
+	} else if (platform === 'linux' && arch === 'ia32') {
+		packageName = 'ffmpeg-6.0-linux-ia32'
+	} else if (platform === 'linux' && arch === 'arm64') {
+		packageName = 'ffmpeg-6.0-linux-arm64'
+	} else if (platform === 'linux' && arch === 'arm') {
+		packageName = 'ffmpeg-6.0-linux-arm'
+	} else if (platform === 'freebsd' && arch === 'x64') {
+		packageName = 'ffmpeg-6.0-freebsd-x64'
+	} else {
+		return undefined
 	}
-	/* else if (process.platform == "darwin" && process.arch == "x64") {
-		const ffmpegPackagePath = await loadPackage("ffmpeg-6.0-macos64")
 
-		return path.join(ffmpegPackagePath, "ffmpeg")
-	}
-	*/ else if (process.platform == "linux" && process.arch == "x64") {
-		const ffmpegPackagePath = await loadPackage("ffmpeg-6.0-linux-amd64")
+	const ffmpegPackagePath = await loadPackage(packageName)
+
+	let filename = packageName
 
-		return path.join(ffmpegPackagePath, "ffmpeg")
-	} else if (await commandExists("ffmpeg")) {
-		return "ffmpeg"
+	if (platform === 'win32') {
+		filename += '.exe'
 	}
 
-	return undefined
+	return path.join(ffmpegPackagePath, filename)
 }
 
 export function getDefaultFFMpegOptionsForSpeech(fileExtension: string, customBitrate?: number) {

package/src/synthesis/VitsTTS.ts

@@ -293,6 +293,12 @@ export const voiceList: SynthesisVoice[] = [
 		languages: ["de-DE", "de"],
 		gender: "male",
 	},
+	{
+		name: "de_DE-mls-medium",
+		languages: ["de-DE", "de"],
+		gender: "unknown",
+		speakerCount: 236
+	},
 
 	{
 		name: "el_GR-rapunzelina-low",
@@ -353,6 +359,12 @@ export const voiceList: SynthesisVoice[] = [
 		languages: ["en-GB", "en"],
 		gender: "female",
 	},
+	{
+		name: "en_GB-cori-high",
+		languages: ["en-GB", "en"],
+		gender: "female",
+	},
+
 
 	{
 		name: "en_US-amy-low",
@@ -443,6 +455,21 @@ export const voiceList: SynthesisVoice[] = [
 		languages: ["en-US", "en"],
 		gender: "female",
 	},
+	{
+		name: "en_US-kristin-medium",
+		languages: ["en-US", "en"],
+		gender: "female",
+	},
+	{
+		name: "en_US-ljspeech-high",
+		languages: ["en-US", "en"],
+		gender: "female",
+	},
+	{
+		name: "en_US-ljspeech-medium",
+		languages: ["en-US", "en"],
+		gender: "female",
+	},
 
 	{
 		name: "es_ES-carlfm-x_low",
@@ -476,6 +503,23 @@ export const voiceList: SynthesisVoice[] = [
 		languages: ["es-MX", "es"],
 		gender: "male",
 	},
+	{
+		name: "es_MX-claude-high",
+		languages: ["es-MX", "es"],
+		gender: "female",
+	},
+
+	{
+		name: "fa_IR-amir-medium",
+		languages: ["fa_IR", "fa"],
+		gender: "male",
+	},
+	{
+		name: "fa_IR-gyro-medium",
+		languages: ["fa_IR", "fa"],
+		gender: "male",
+	},
+
 
 	{
 		name: "fi_FI-harri-low",
@@ -514,6 +558,17 @@ export const voiceList: SynthesisVoice[] = [
 		gender: "unknown",
 		speakerCount: 2
 	},
+	{
+		name: "fr_FR-mls-medium",
+		languages: ["fr-FR", "fr"],
+		gender: "unknown",
+		speakerCount: 125
+	},
+	{
+		name: "fr_FR-tom-medium",
+		languages: ["fr-FR", "fr"],
+		gender: "male",
+	},
 
 	{
 		name: "hu_HU-anna-medium",
@@ -605,6 +660,12 @@ export const voiceList: SynthesisVoice[] = [
 		languages: ["nl-NL", "nl"],
 		gender: "female",
 	},
+	{
+		name: "nl_NL-mls-medium",
+		languages: ["nl-NL", "nl"],
+		gender: "unknown",
+		speakerCount: 52,
+	},
 
 	{
 		name: "nl_BE-nathalie-x_low",
@@ -705,6 +766,12 @@ export const voiceList: SynthesisVoice[] = [
 		gender: "female",
 	},
 
+	{
+		name: "sl_SI-artur-medium",
+		languages: ["sl_SI", "sl"],
+		gender: "male",
+	},
+
 	{
 		name: "sr_RS-serbski_institut-medium",
 		languages: ["sr-RS", "sr"],
@@ -734,6 +801,11 @@ export const voiceList: SynthesisVoice[] = [
 		languages: ["tr-TR", "tr"],
 		gender: "male",
 	},
+	{
+		name: "tr_TR-fettah-medium",
+		languages: ["tr-TR", "tr"],
+		gender: "male",
+	},
 
 	{
 		name: "uk_UA-lada-x_low",