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

# 🎙️ TTS WhatsApp - Text-to-Speech Voice Messages

Send voice messages on WhatsApp with high-quality text-to-speech in 40+ languages.

## ✨ 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** installed:
   ```bash
   pip3 install --user piper-tts
   ```

2. **FFmpeg** installed:
   ```bash
   # macOS
   brew install ffmpeg

   # Linux
   apt install ffmpeg  # or yum, pacman, etc.
   ```

3. **Piper voice models** downloaded:
   - Download from [Hugging Face](https://huggingface.co/rhasspy/piper-voices)
   - Place in `~/.clawdbot/skills/piper-tts/models/`
   - Default: `fr_FR-siwis-medium.onnx`

## 🚀 Quick Start

### Basic usage (with environment variables)

```bash
tts-whatsapp "Hello, this is a test message"
```

### Specify recipient

```bash
tts-whatsapp "Hello" --target "+15555550123"
```

### Send to a WhatsApp group

```bash
tts-whatsapp "Hello everyone" --target "120363257357161211@g.us"
```

### Change language

```bash
# English
tts-whatsapp "Hello world" --lang en_US --voice lessac

# Spanish
tts-whatsapp "Hola mundo" --lang es_ES --voice carlfm

# German
tts-whatsapp "Guten Tag" --lang de_DE --voice thorsten
```

### Adjust voice quality

```bash
tts-whatsapp "High quality audio" --quality high
```

### Generate without sending

```bash
tts-whatsapp "Test" --no-send
```

## 🔧 Configuration

### Environment Variables

Set these in `~/.clawdbot/clawdbot.json` under the skill configuration:

```json
{
  "skills": {
    "entries": {
      "tts_whatsapp": {
        "enabled": true,
        "env": {
          "PIPER_BIN_PATH": "/path/to/piper",
          "WHATS...