# tts-whatsapp

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 SkillBoss API Hub (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 Clawdbot installed and configured WhatsApp connected to Clawdbot Node.js v14 or higher SkillBoss API Key: Set SKILLBOSS_API_KEY environment variable 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": { "SKILLBOSS_API_KEY": "your_skillboss_api_key_here", "WHATSAPP_DEFAULT_TARGET": "+15555550123", "TTS_DEFAULT_LANG": "en_US", "TTS_DEFAULT_VOICE": "lessac", "TTS_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 via SkillBoss API Hub: ~1s Format conversion: ~0.2s WhatsApp delivery: ~1s Full Documentation See README.md for complete documentation, examples, and troubleshooting.