docs: Add TTS engine quick reference guide
- Created user-friendly quick reference card - Clear decision guide for choosing between engines - Quick start instructions for both engines - Feature comparison table - Troubleshooting tips and pro tips - Links to detailed documentation Makes it easy for users to understand and choose the right engine.
This commit is contained in:
135
TTS_ENGINE_QUICK_REFERENCE.md
Normal file
135
TTS_ENGINE_QUICK_REFERENCE.md
Normal file
@@ -0,0 +1,135 @@
|
||||
# TTS Engine Quick Reference
|
||||
|
||||
## 🎯 Which Engine Should I Use?
|
||||
|
||||
### Use Kokoro TTS (Default) if you want:
|
||||
- ✅ **Zero setup** - works immediately
|
||||
- ✅ **High quality** voices
|
||||
- ✅ **Many voices** - 54 voices, 9 languages
|
||||
- ✅ **Multiple languages** - English, French, Japanese, Spanish, etc.
|
||||
|
||||
### Use Piper TTS if you want:
|
||||
- ✅ **Pitch control** - adjust voice pitch per character
|
||||
- ✅ **Fast synthesis** - quicker generation
|
||||
- ✅ **Lower memory** - smaller models
|
||||
- ⚠️ **Manual setup required** - one-time voice download
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Quick Start
|
||||
|
||||
### Kokoro TTS (No Setup)
|
||||
1. Start the app
|
||||
2. It just works! ✨
|
||||
|
||||
### Piper TTS (3-Minute Setup)
|
||||
1. Install Piper: `cd backend && ./install_piper.sh`
|
||||
2. Download voices from: https://github.com/rhasspy/piper/releases/tag/v1.2.0
|
||||
3. Place `.onnx` and `.onnx.json` files in `backend/piper_models/`
|
||||
4. Done! See `backend/PIPER_SETUP.md` for details
|
||||
|
||||
---
|
||||
|
||||
## 🎛️ How to Switch Engines
|
||||
|
||||
### In the UI:
|
||||
1. Go to **Voice Assignment** screen
|
||||
2. Click **"Kokoro TTS"** or **"Piper TTS"** button
|
||||
3. Voice dropdown updates automatically
|
||||
|
||||
### Via API:
|
||||
```bash
|
||||
curl -X POST http://localhost:8000/api/tts/engines \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"engine": "piper"}'
|
||||
```
|
||||
|
||||
### Via Environment Variable:
|
||||
```bash
|
||||
# In backend/.env
|
||||
TTS_ENGINE=piper # or kokoro
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎵 Pitch Control (Piper Only)
|
||||
|
||||
Adjust voice pitch per character in semitones:
|
||||
|
||||
```
|
||||
+12 = Very high (one octave up)
|
||||
+6 = Child-like
|
||||
+3 = Slightly higher (feminine)
|
||||
0 = Original voice
|
||||
-3 = Slightly lower (masculine)
|
||||
-6 = Deep voice
|
||||
-12 = Very deep (one octave down)
|
||||
```
|
||||
|
||||
**Recommended:**
|
||||
- Female characters: +2 to +5
|
||||
- Male characters: -2 to -5
|
||||
- Children: +5 to +8
|
||||
|
||||
---
|
||||
|
||||
## 📊 Feature Comparison
|
||||
|
||||
| Feature | Kokoro | Piper |
|
||||
|---------|--------|-------|
|
||||
| Setup | None | Manual |
|
||||
| Quality | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
|
||||
| Speed | Medium | Fast |
|
||||
| Voices | 54 | 5+ |
|
||||
| Languages | 9 | English |
|
||||
| Pitch Control | ❌ | ✅ |
|
||||
| Memory | 500MB | 10-50MB |
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Troubleshooting
|
||||
|
||||
### "Voice preview failed"
|
||||
- **Kokoro**: Check internet connection (first-time model download)
|
||||
- **Piper**: Download voice models manually (see PIPER_SETUP.md)
|
||||
|
||||
### "Voice model not found"
|
||||
- Download `.onnx` and `.onnx.json` files
|
||||
- Place in `backend/piper_models/`
|
||||
- Restart backend server
|
||||
|
||||
### "Piper not found"
|
||||
- Run `./install_piper.sh`
|
||||
- Or install from: https://github.com/rhasspy/piper/releases
|
||||
|
||||
---
|
||||
|
||||
## 📚 Documentation
|
||||
|
||||
- **Piper Setup**: `backend/PIPER_SETUP.md`
|
||||
- **Piper Guide**: `backend/PIPER_TTS_GUIDE.md`
|
||||
- **Status**: `PIPER_STATUS.md`
|
||||
- **Full Details**: `PIPER_TTS_INTEGRATION.md`
|
||||
|
||||
---
|
||||
|
||||
## 💡 Pro Tips
|
||||
|
||||
1. **Start with Kokoro** - Try it first, it's easier
|
||||
2. **Try Piper for variety** - Pitch control adds character depth
|
||||
3. **Mix engines** - Use Kokoro for most, Piper for special characters
|
||||
4. **Download multiple voices** - More variety in your audiobooks
|
||||
5. **Test voices** - Use preview button before generating full audiobook
|
||||
|
||||
---
|
||||
|
||||
## 🆘 Need Help?
|
||||
|
||||
1. Check `backend/PIPER_SETUP.md` for setup
|
||||
2. Run `python test_piper_direct.py` to test Piper
|
||||
3. Check backend logs for detailed errors
|
||||
4. Fall back to Kokoro if Piper has issues
|
||||
|
||||
---
|
||||
|
||||
**Remember:** Both engines work great! Kokoro is easier, Piper is more advanced. Choose based on your needs. 🎉
|
||||
Reference in New Issue
Block a user