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,69 @@
+# DECTalk Voices Reference
+
+The 9 original DECTalk voices, each with unique characteristics.
+
+## Voice List
+
+| Voice | Description | Type |
+|-------|-------------|------|
+| paul | Perfect Paul (default, Moonbase Alpha) | Male |
+| betty | Beautiful Betty | Female |
+| harry | Huge Harry (deep voice) | Male |
+| frank | Frail Frank (elderly) | Male |
+| dennis | Doctor Dennis | Male |
+| kit | Kit the Kid | Child |
+| ursula | Uppity Ursula | Female |
+| rita | Rough Rita (gravelly) | Female |
+| wendy | Whispering Wendy (soft) | Female |
+
+## Using Voices in Discord
+
+### Set Your Voice
+```
+[p]ttstoy myvoice paul
+[p]tts aeiou john madden
+```
+
+The voice command `[:np]` is automatically prepended to your text.
+
+### Override Voice Mid-Text
+You can use DECTalk commands to change voices within your message:
+```
+[p]tts [:nh]I'm gonna eat a pizza. [:dial67589340] Hi, can i order a pizza? [:nv]no! [:nh]why? [:nv] cuz you are john madden![:np]
+```
+
+Voice commands:
+- `[:np]` - Paul
+- `[:nb]` - Betty
+- `[:nh]` - Harry
+- `[:nf]` - Frank
+- `[:nd]` - Dennis
+- `[:nk]` - Kit
+- `[:nu]` - Ursula
+- `[:nr]` - Rita
+- `[:nw]` - Wendy
+
+## Testing Voices
+
+```bash
+# Test all voices
+for voice in paul betty harry frank dennis kit ursula rita wendy; do
+    echo "Testing $voice..."
+    curl "http://127.0.0.1:3001/say?text=Hello%20I%20am%20$voice&voice=$voice" -o "${voice}.mp3"
+done
+```
+
+## In Discord
+
+```
+# Set voice and speak
+[p]ttstoy voice paul
+[p]tts aeiou john madden
+
+# Change voice
+[p]ttstoy voice betty
+[p]tts Hello, I am Beautiful Betty
+
+# Override voice in text
+[p]tts [:nh]Deep voice [:nb]now female voice [:np]back to paul
+```