Edge-TTS Skill

Overview

Generate high-quality text-to-speech audio using Microsoft Edge's neural TTS service via the node-edge-tts npm package. Supports multiple languages, voices, adjustable speed/pitch, and subtitle generation.

Quick Start

When you detect TTS intent from triggers or user request:

1. Call the tts tool (Clawdbot built-in) to convert text to speech
2. The tool returns a MEDIA: path
3. Clawdbot routes the audio to the current channel

// Example: Built-in tts tool usage
tts("Your text to convert to speech")
// Returns: MEDIA: /path/to/audio.mp3

Trigger Detection

Recognize "tts" keyword as TTS requests. The skill automatically filters out TTS-related keywords from text before conversion to avoid converting the trigger words themselves to audio.

Advanced Customization

Using the Node.js Scripts

For more control, use the bundled scripts directly:

TTS Converter

cd scripts
npm install
node tts-converter.js "Your text" --voice en-US-AriaNeural --rate +10% --output output.mp3

Options:

• --voice, -v: Voice name (default: en-US-AriaNeural)
• --lang, -l: Language code (e.g., en-US, es-ES)
• --format, -o: Output format (default: audio-24khz-48kbitrate-mono-mp3)
• --pitch: Pitch adjustment (e.g., +10%, -20%, default)
• --rate, -r: Rate adjustment (e.g., +10%, -20%, default)
• --volume: Volume adjustment (e.g., +0%, -10%, default)
• --save-subtitles, -s: Save subtitles as JSON file
• --output, -f: Output file path (default: tts_output.mp3)
• --proxy, -p: Proxy URL (e.g., http://localhost:7890)
• --timeout: Request timeout in milliseconds (default: 10000)
• --list-voices, -L: List available voices

Configuration Manager

cd scripts
npm install
node config-manager.js --set-voice en-US-AriaNeural

node config-manager.js --set-rate +10%

node config-manager.js --get

node config-manager.js --reset

Voice Selection

Common voices (use --list-voices for full list):

English:

• en-US-MichelleNeural (female, natural, default)
• en-US-AriaNeural (female, natural)
• en-US-GuyNeural (male, natural)
• en-GB-SoniaNeural (female, British)
• en-GB-RyanNeural (male, British)

Other Languages:

• es-ES-ElviraNeural (Spanish, Spain)
• fr-FR-DeniseNeural (French)
• de-DE-KatjaNeural (German)
• ja-JP-NanamiNeural (Japanese)
• zh-CN-XiaoxiaoNeural (Chinese)
• ar-SA-ZariyahNeural (Arabic)

Rate Guidelines

Rate values use percentage format:

• "default": Normal speed
• "-20%" to "-10%": Slow, clear (tutorials, stories, accessibility)
• "+10%" to "+20%": Slightly fast (summaries)
• "+30%" to "+50%": Fast (news, efficiency)

Output Formats