🎙️ TTS WhatsApp - Voice Messages in 40+ Languages
Send high-quality text-to-speech voice messages on WhatsApp with automatic delivery. Supports 40+ languages, personal messages, and group broadcasts.
✨ Features
- 🎙️ High-quality TTS powered by Piper (40+ languages)
- 🎵 Automatic conversion to OGG/Opus (WhatsApp format)
- 📤 Automatic sending via Clawdbot
- 👥 Group support - Send to individuals or WhatsApp groups
- 🌍 Multi-language - French, English, Spanish, German, and 40+ more
- 🧹 Smart cleanup - Auto-delete files after successful send
- ⚡ Fast - ~2-3s from command to delivery
📦 Prerequisites
- Piper TTS:
pip3 install --user piper-tts - FFmpeg:
brew install ffmpeg(macOS) orapt install ffmpeg(Linux) - Voice models: Download from Hugging Face
- Place in~/.clawdbot/skills/piper-tts/models/
- Example:fr_FR-siwis-medium.onnx
🚀 Quick Start
Basic usage
tts-whatsapp "Hello, this is a test" --target "+15555550123"
Send to WhatsApp group
tts-whatsapp "Hello everyone" --target "[email protected]"
Change language
tts-whatsapp "Hola mundo" --lang es_ES --voice carlfm --target "+34..."
Different quality levels
tts-whatsapp "High quality" --quality high --target "+1..."
🌍 Supported Languages
- 🇫🇷 French (
fr_FR): siwis, upmc, tom - 🇬🇧 English GB (
en_GB): alan, alba - 🇺🇸 English US (
en_US): lessac, amy, joe - 🇪🇸 Spanish (
es_ES,es_MX): carlfm, davefx - 🇩🇪 German (
de_DE): thorsten, eva_k - 🇮🇹 Italian (
it_IT): riccardo - 🇵🇹 Portuguese (
pt_BR,pt_PT): faber - 🇳🇱 Dutch (
nl_NL): mls, rdh - 🇷🇺 Russian (
ru_RU): dmitri, irina - And 30+ more!
🔧 Configuration
Configure in ~/.clawdbot/clawdbot.json:
{
"skills": {
"entries": {
"tts_whatsapp": {
"enabled": true,
"env": {
"WHATSAPP_DEFAULT_TARGET": "+15555550123",
"PIPER_DEFAULT_LANG": "en_US",
"PIPER_DEFAULT_VOICE": "lessac",
"PIPER_DEFAULT_QUALITY": "medium"
}
}
}
}
}
🎛️ All Options
--target NUMBER WhatsApp number or group ID
--message TEXT Text message with audio
--lang LANGUAGE Language (default: fr_FR)
--voice VOICE Voice name (default: auto)
--quality QUALITY x_low, low, medium, high
--speed SPEED Playback speed (default: 1.0)
--no-send Don't send automatically
📊 Performance
~2.3s total for a 10-second message:
- TTS generation: ~1s
- Format conversion: ~0.2s
- WhatsApp delivery: ~1s
📚 Full Documentation
See README.md for complete documentation, examples, and troubleshooting.
