goobits-tts 1.1.4

Command-line text-to-speech tool with multiple providers, voice cloning, and smart auto-selection

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

Provider	Cost	Quality	Speed	Voice Cloning	Best For
Edge TTS	Free	Good	Fast	No	Development, general use
OpenAI	Paid	Excellent	Very Fast	No	Production, real-time
ElevenLabs	Paid	Excellent	Fast	Yes	Premium quality, cloning
Google Cloud	Paid	Excellent	Fast	No	Enterprise, multilingual
Chatterbox	Free	Variable	Fast	Yes	Local processing, privacy

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.