gh-dnvriend-elevenlabs-tts-tool-plugins-elevenlabs-tts-tool/commands/synthesize.md

description, argument-hint

description	argument-hint
Convert text to speech with ElevenLabs	text

Convert TEXT to speech using ElevenLabs API. Play through speakers or save to file.

Usage

elevenlabs-tts-tool synthesize TEXT [OPTIONS]

Arguments

• TEXT: Text to synthesize (required, or use --stdin)
• --stdin, -s: Read text from stdin instead
• --voice, -v NAME: Voice name or ID (default: rachel)
• --model, -m ID: Model ID (default: eleven_turbo_v2_5)
• --output, -o PATH: Save to file instead of playing
• --format, -f FORMAT: Output format (default: mp3_44100_128)

Examples

# Basic usage
elevenlabs-tts-tool synthesize "Hello world"

# Different voice
elevenlabs-tts-tool synthesize "Hello" --voice adam

# Emotional expression (requires eleven_v3)
elevenlabs-tts-tool synthesize "[happy] Welcome!" --model eleven_v3

# Read from stdin
echo "Text" | elevenlabs-tts-tool synthesize --stdin

# Save to file
elevenlabs-tts-tool synthesize "Text" --output speech.mp3

Output

Plays audio through speakers or saves to file in specified format.