tts-playground-cli

Text-to-Speech CLI for Node.js — Instant Voice in Terminal

Generate realistic voice from your terminal in 2 seconds. No install needed.

npx tts-playground-cli "hello world"

Quick Start

# No install required — just use npx
npx tts-playground-cli "hello world"

Examples

# Basic usage
tts "hello world"

# Choose a voice
tts "hey there" --voice female
tts "what's up" --voice male

# Add emotion
tts "hello bro" --voice female --emotion happy
tts "I am speed" --voice male --emotion excited
tts "goodbye..." --emotion sad

# Adjust speed
tts "slow down" --speed 0.8
tts "turbo mode" --speed 1.5

# Combine flags
tts "this is awesome" --voice female --emotion excited --speed 1.2

# Save to file
tts "save this line" --save output.wav

Flags

| Flag | Alias | Description | Default | |------|-------|-------------|---------| | --voice <voice> | -v | female, male, or any system voice name | female | | --emotion <emotion> | -e | happy, excited, sad, calm, angry, normal | normal | | --speed <number> | -s | Speed multiplier (e.g. 0.8, 1.5) | 1.0 | | --save <file> | — | Save audio to .wav file instead of playing | — | | --version | -V | Show version number | — | | --help | -h | Show help | — |

Emotion → Speed mapping

| Emotion | Speed modifier | |---------|---------------| | happy | 1.2x | | excited | 1.5x | | sad | 0.75x | | calm | 0.9x | | angry | 1.3x | | normal | 1.0x |

Install globally

npm install -g tts-playground-cli
tts "now I'm global"

How it works

Uses your OS's built-in text-to-speech engine — no API key, no internet required:

| Platform | Engine | |----------|--------| | Windows | Microsoft SAPI (Zira, David) | | macOS | say command (Samantha, Alex) | | Linux | espeak |

System voice names

You can pass any installed system voice by name:

tts "hello" --voice "Microsoft Zira Desktop"   # Windows
tts "hello" --voice "Samantha"                  # macOS
tts "hello" --voice "Victoria"                  # macOS alternate

List available voices:

• Windows: Settings → Time & Language → Speech → Manage voices
• macOS: say -v ? in terminal
• Linux: espeak --voices

License

MIT