Add ttstoy cog

2026-06-05 16:41:55 -05:00
parent 0e9f4a5224
commit 6739b2d6f1
975 changed files with 8216 additions and 0 deletions
@@ -0,0 +1,83 @@
+# Installing Authentic DECTalk Server
+
+This guide shows how to install and run the authentic DECTalk server with the Moonbase Alpha voice.
+
+## Quick Install
+
+```bash
+cd ~/devcogs/ttstoy/dectalk-server
+npm install
+```
+
+This installs the `dectalk` npm package which includes the authentic DECTalk binaries.
+
+## What You Get
+
+The `dectalk` package provides:
+- Perfect Paul voice (the Moonbase Alpha voice)
+- Authentic DECTalk synthesis engine
+- Support for DECTalk phoneme commands
+- Same voice used by Stephen Hawking
+
+## Start the Server
+
+```bash
+PORT=3001 npm start
+```
+
+Or use the start script:
+```bash
+./start.sh
+```
+
+## Test It
+
+```bash
+# Test health
+curl http://127.0.0.1:3001/health
+
+# Generate audio
+curl "http://127.0.0.1:3001/say?text=aeiou" -o aeiou.mp3
+ffplay aeiou.mp3
+```
+
+## Configure TTSTOY
+
+In Discord:
+```
+[p]ttstoy mode dectalk
+[p]ttstoy dectalkurl http://127.0.0.1:3001
+[p]tts aeiou john madden
+```
+
+## Troubleshooting
+
+### "Cannot find module 'dectalk'"
+
+Run `npm install` in the dectalk-server directory.
+
+### Port already in use
+
+Use a different port:
+```bash
+PORT=3002 npm start
+```
+
+### Linux dependency issues
+
+The dectalk package may need additional libraries:
+```bash
+sudo apt install libasound2
+```
+
+## DECTalk Commands
+
+You can use DECTalk phoneme commands in your text:
+
+```
+[p]tts [:phoneme on] hehlow werld
+[p]tts [:rate 200] speaking very fast
+[p]tts [:dv ap 100] aeiou
+```
+
+These commands control pitch, rate, and other voice parameters just like in Moonbase Alpha.