| name | lh-edge-tts |
| description | Text-to-speech conversion using Python edge-tts for generating audio from text.
Supports multiple voices, languages, speed adjustment, pitch control, and subtitle generation.
Use when: (1) User requests audio/voice output with the "tts" trigger or keyword. (2) Content needs to be spoken rather than read (multitasking, accessibility, driving, cooking). (3) User wants a specific voice, speed, pitch, or format for TTS output.
|
Edge-TTS Skill
Overview
Generate high-quality text-to-speech audio using Microsoft Edge's neural TTS service via Python edge-tts. Supports multiple languages, voices, adjustable speed/pitch, and subtitle generation (SRT/VTT).
Quick Start
When you detect TTS intent from triggers or user request:
- Call the tts tool (Clawdbot built-in) to convert text to speech
- The tool returns a MEDIA: path
- Clawdbot routes the audio to the current channel
Trigger Detection
Recognize "tts" keyword as TTS requests. The skill automatically filters out TTS-related keywords from text before conversion.
Advanced Customization
Using the Python Scripts
For more control, use the bundled scripts directly:
TTS Converter
cd scripts
python3 tts_converter.py "Your text" --voice en-US-AriaNeural --rate +10% -o output.mp3
python3 tts_converter.py -f input.txt --voice zh-CN-XiaoxiaoNeural -o output.mp3
python3 tts_converter.py -f input.txt -v zh-CN-YunxiNeural -r "+10%" -o output.mp3 -s output.vtt
Options:
--voice, -v: Voice name (default: en-US-MichelleNeural)--lang, -l: Language code (e.g., en-US, zh-CN)--rate, -r: Rate adjustment (e.g., +10%, -20%)--volume: Volume adjustment (e.g., +0%, -50%)--pitch: Pitch adjustment (e.g., +0Hz, -10Hz)--output, -o: Output file path (default: temp file)--subtitles, -s: Save subtitles to file (.vtt or .srt)--file, -f: Read text from file--proxy, -p: Proxy URL--timeout: Receive timeout in seconds (default: 60)--list-voices, -L: List available voices--lang-filter: Filter voices by language (used with --list-voices)
Configuration Manager
cd scripts
python3 config_manager.py --set voice zh-CN-XiaoxiaoNeural
python3 config_manager.py --set rate "+10%"
python3 config_manager.py --get
python3 config_manager.py --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)
Chinese:
zh-CN-XiaoxiaoNeural (female)zh-CN-YunyangNeural (male, news style)zh-CN-YunxiNeural (male, natural)
Other Languages:
es-ES-ElviraNeural (Spanish)fr-FR-DeniseNeural (French)de-DE-KatjaNeural (German)ja-JP-NanamiNeural (Japanese)ar-SA-ZariyahNeural (Arabic)
Rate Guidelines
Rate values use percentage format:
"+0%": Normal speed (default)"-20%" to "-10%": Slow, clear (tutorials, stories, accessibility)"+10%" to "+20%": Slightly fast (summaries)"+30%" to "+50%": Fast (news, efficiency)
Resources
scripts/tts_converter.py
Main TTS conversion script using edge-tts. Generates audio files with customizable voice, rate, volume, pitch. Supports subtitle generation (VTT/SRT) and voice listing.
scripts/config_manager.py
Manages persistent user preferences for TTS settings. Stores config in ~/.tts-config.json.
Voice Testing
Test different voices and preview audio quality at: https://tts.travisvn.com/
Installation
pip install edge-tts
Workflow
- Detect intent: Check for "tts" trigger or keyword in user message
- Choose method: Use built-in
tts tool for simple requests, or scripts/tts_converter.py for customization
- Generate audio: Convert the target text
- Return to user: The tts tool returns a MEDIA: path; Clawdbot handles delivery
Testing
Basic Test
cd scripts
python3 tts_converter.py "Hello, this is a test." -o test-output.mp3
Chinese Test
python3 tts_converter.py "这是一个测试" -v zh-CN-XiaoxiaoNeural -o test-zh.mp3
List Voices
python3 tts_converter.py --list-voices --lang-filter zh
Configuration Test
python3 config_manager.py --get
python3 config_manager.py --set voice en-US-GuyNeural
python3 config_manager.py --get voice
Notes
- edge-tts uses Microsoft Edge's online TTS service
- No API key needed (free service)
- Output is MP3 format by default
- Requires internet connection
- Supports subtitle generation (standard VTT/SRT format)
- Temporary File Handling: By default, audio files are saved to the system's temporary directory with unique filenames. Specify a custom output path with
--output for permanent storage.
- TTS keyword filtering: Automatically filters out TTS-related keywords from text before conversion
- Neural voices (ending in
Neural) provide higher quality
