Goobits TTS

One CLI for all TTS providers. Stream to speakers, save to files, or clone voices. Works with your text processing pipeline.

Supported Providers: Edge TTS • OpenAI • ElevenLabs • Google Cloud • Chatterbox

Quick Start

1. Install: ./setup.sh install
2. Test: tts "Hello world"
3. Done: You just synthesized speech

Basic Usage

# Stream audio to speakers
tts "Hello world"
echo "Hello world" | tts

# Save to file
tts save "Hello world" -o greeting.mp3

# Use specific provider
tts @edge "Hello from Microsoft"
tts @openai "Hello from OpenAI"
tts @elevenlabs "Hello from ElevenLabs"

Provider Comparison

Configuration

# Set API keys
tts config set openai_api_key YOUR_KEY
tts config set elevenlabs_api_key YOUR_KEY
tts config set google_api_key YOUR_KEY

# View configuration
tts config show

# Interactive editor
tts config edit

Voice Selection

# Browse voices interactively
tts voices

# Use specific voice
tts @edge "Hello" --voice en-US-AriaNeural
tts @openai "Hello" --voice alloy

Pipeline Integration

Works seamlessly with other Goobits tools:

# Speech → Text → Speech
stt recording.wav | tts @edge

# Text transformation → Speech
echo "Hello" | ttt "translate to Spanish" | tts @google

# Document processing
tts document report.html --emotion-profile technical

Documentation

• Getting Started - Installation and first steps
• User Guide - Complete reference
• Provider Guide - Provider comparison and setup
• Advanced Usage - Pipelines and document processing

Installation Options

Recommended (all providers):

./setup.sh install

Alternative methods:

pipx install goobits-tts[all]      # Global install
pip install goobits-tts[all]       # User install
pip install goobits-tts[openai]    # Single provider

Development:

./setup.sh install --dev

System Requirements

• Python 3.8+
• FFmpeg (for audio processing)
• Audio output device

Related Projects

Part of the Goobits AI toolkit:

• Matilda - AI assistant
• Goobits STT - Speech-to-Text
• Goobits TTS - Text-to-Speech (this project)
• Goobits TTT - Text-to-Text processing

License

MIT License - See LICENSE file for details

Contributing

Contributions welcome! See CLAUDE.md for development setup and guidelines.