Initial commit

commands/synthesize.md

@@ -0,0 +1,44 @@
+---
+description: Convert text to speech with ElevenLabs
+argument-hint: text
+---
+
+Convert TEXT to speech using ElevenLabs API. Play through speakers or save to file.
+
+## Usage
+
+```bash
+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
+
+```bash
+# 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.