cli-reference.md

CLI Reference

Usage

dotnet run --project src/ElBruno.QwenTTS -- --model-dir <path> --text "<text>" [options]

Options

Argument	Default	Description
--model-dir	(required)	Path to model directory (models auto-download if missing)
--text	(required)	Text to synthesize
--speaker	Ryan	Speaker voice name (see below)
--language	auto	Language: english, spanish, chinese, japanese, korean, russian, german, french, portuguese, italian, or auto
--output	output.wav	Output WAV file path
--instruct	(none)	Voice style instruction (e.g., "speak happily")

Available Speakers

Speaker	Notes
ryan	English male
serena	English female
vivian	English female
aiden	English male
eric	Sichuan dialect
dylan	Beijing dialect
uncle_fu	Chinese male
ono_anna	Japanese female
sohee	Korean female

Examples

English

dotnet run --project src/ElBruno.QwenTTS -- --model-dir python/onnx_runtime --text "Hello, this is a test." --speaker ryan --language english --output hello.wav
dotnet run --project src/ElBruno.QwenTTS -- --model-dir python/onnx_runtime --text "Welcome to the future of speech synthesis." --speaker serena --output welcome.wav
dotnet run --project src/ElBruno.QwenTTS -- --model-dir python/onnx_runtime --text "This is Aiden speaking with excitement." --speaker aiden --instruct "speak with excitement" --output excited.wav

Spanish

dotnet run --project src/ElBruno.QwenTTS -- --model-dir python/onnx_runtime --text "Hola, esta es una prueba de texto a voz." --speaker ryan --language spanish --output hola.wav
dotnet run --project src/ElBruno.QwenTTS -- --model-dir python/onnx_runtime --text "Bienvenidos al futuro de la sintesis de voz." --speaker serena --language spanish --output bienvenidos.wav
dotnet run --project src/ElBruno.QwenTTS -- --model-dir python/onnx_runtime --text "Hablando con emocion y energia." --speaker aiden --language spanish --instruct "speak with excitement" --output emocion.wav

Russian

dotnet run --project src/ElBruno.QwenTTS -- --model-dir python/onnx_runtime --text "Привет, это тест синтеза речи." --speaker ryan --language russian --output russian.wav

File Reader (batch text/SRT to audio)

See File Reader for full details.

dotnet run --project src/ElBruno.QwenTTS.FileReader -- --model-dir python/onnx_runtime --input samples/hello_demo.txt --speaker ryan --language english --output-dir output/hello
dotnet run --project src/ElBruno.QwenTTS.FileReader -- --model-dir python/onnx_runtime --input samples/hola_demo.txt --speaker ryan --language spanish --output-dir output/hola
dotnet run --project src/ElBruno.QwenTTS.FileReader -- --model-dir python/onnx_runtime --input samples/demo_subtitles.srt --speaker serena --output-dir output/subtitles