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 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

1. **Piper TTS**: `pip3 install --user piper-tts`
2. **FFmpeg**: `brew install ffmpeg` (macOS) or `apt install ffmpeg` (Linux)
3. **Voice models**: Download from [Hugging Face](https://huggingface.co/rhasspy/piper-voices)
   - Place in `~/.clawdbot/skills/piper-tts/models/`
   - Example: `fr_FR-siwis-medium.onnx`

## 🚀 Quick Start

### Basic usage
```bash
tts-whatsapp "Hello, this is a test" --target "+15555550123"
```

### Send to WhatsApp group
```bash
tts-whatsapp "Hello everyone" --target "120363257357161211@g.us"
```

### Change language
```bash
tts-whatsapp "Hola mundo" --lang es_ES --voice carlfm --target "+34..."
```

### Different quality levels
```bash
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!

[Full voice list →](https://rhasspy.github.io/piper-samples/)

## 🔧 Configuration

Configure in `~/.clawdbot/clawdbot.json`:

```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](README.md) for complete documentation, examples, and troubleshooting.