kingston/scrapyard-cogworks
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore: change DECTalk port to 33001, Morshu port to 33002, add AI context file

Browse Source
This commit is contained in:
Kingston-SCYD
2026-06-09 10:47:06 -05:00
parent ee3c452670
commit f13b88ab82
10 changed files with 88 additions and 36 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.ai-context.md
+52
View File
@@ -0,0 +1,52 @@
# scrapyard-cogworks
## Overview
Red-DiscordBot cog pack for Kingston's Scrapyard Discord server. Primary cog is **ttstoy** — a multi-engine TTS system with Discord integration, web UI, and Minecraft mod support.
## Cogs
### ttstoy
Multi-engine TTS cog with Discord slash commands, web UI, and Minecraft server integration.
**TTS Engines:**
- `chatterbox` — AI voice synthesis via Chatterbox API (port 8099)
- `clone` — Voice cloning from reference audio
- `dectalk` — DECTalk retro TTS server (port 33001)
- `vox` — Half-Life VOX concatenative speech
- `morshu` — Morshuspeak meme TTS server (port 33002)
- `minimax` — MiniMax cloud TTS API
**Key components:**
- `ttstoy.py` — Main cog (~150KB): Discord commands, queue system, voice management, guild config
- `webui/app.py` — Flask web UI for browser-based TTS with login system
- `dectalk-server/` — Node.js DECTalk wrapper (Express, port 33001)
- `morshu-server/server.py` — Python HTTP server for Morshuspeak (port 33002)
- `morshutalk_engine.py` — Audio concatenation engine for Morshu voice
- `vox_engine.py` — Half-Life VOX word concatenation
- `vox_words/`, `vox2_words/` — VOX audio sample packs
**Web UI features:**
- User login via Discord token (issued by bot command `[p]ttstoy login`)
- Voice management (predefined + personal voices)
- Minecraft `/tts` integration via `/api/mc/tts` proxy endpoint
- DECTalk page with server status
### autoroom
Auto voice channel creation/management cog (fork of PCXCogs AutoRoom).
## Architecture
```
Discord user → [p]ttstoy commands → ttstoy.py → Chatterbox API (port 8099)
Web UI user → webui/app.py → ttstoy.py → Chatterbox API / DECTalk (33001) / Morshu (33002)
Minecraft → mod → webui /api/mc/tts → Chatterbox API / DECTalk / Morshu
```
## Related Repositories
- `http://192.168.0.200:3000/kingston/chatterbox-ttstoy-api` — Chatterbox TTS API server
- `http://192.168.0.200:3000/kingston/minecraft-tts-server-mod` — NeoForge Minecraft TTS mod
## Tech Stack
- Python 3.10+, Red-DiscordBot (discord.py)
- Flask (web UI)
- Node.js/Express (DECTalk server)
- pydub, librosa (audio processing)
ttstoy/dectalk-server/INSTALL.md
+5 -5
View File
@@ -22,7 +22,7 @@ The `dectalk` package provides:
## Start the Server
```bash
PORT=3001 npm start
PORT=33001 npm start
```
Or use the start script:
@@ -34,10 +34,10 @@ Or use the start script:
```bash
# Test health
curl http://127.0.0.1:3001/health
curl http://127.0.0.1:33001/health
# Generate audio
curl "http://127.0.0.1:3001/say?text=aeiou" -o aeiou.mp3
curl "http://127.0.0.1:33001/say?text=aeiou" -o aeiou.mp3
ffplay aeiou.mp3
```
@@ -46,7 +46,7 @@ ffplay aeiou.mp3
In Discord:
```
[p]ttstoy mode dectalk
[p]ttstoy dectalkurl http://127.0.0.1:3001
[p]ttstoy dectalkurl http://127.0.0.1:33001
[p]tts aeiou john madden
```
@@ -60,7 +60,7 @@ Run `npm install` in the dectalk-server directory.
Use a different port:
```bash
PORT=3002 npm start
PORT=33002 npm start
```
### Linux dependency issues
ttstoy/dectalk-server/README.md
+4 -4
View File
@@ -175,7 +175,7 @@ DECTalk supports special commands for controlling speech:
Example:
```bash
curl "http://127.0.0.1:3001/say?text=%5B:rate%20150%5DHello%20world&voice=paul" -o test.mp3
curl "http://127.0.0.1:33001/say?text=%5B:rate%20150%5DHello%20world&voice=paul" -o test.mp3
```
You can also use these in Discord:
@@ -212,13 +212,13 @@ DECTalk includes 9 classic voices:
**Direct API:**
```bash
curl "http://127.0.0.1:3001/say?text=Hello&voice=paul" -o paul.mp3
curl "http://127.0.0.1:3001/say?text=Hello&voice=betty" -o betty.mp3
curl "http://127.0.0.1:33001/say?text=Hello&voice=paul" -o paul.mp3
curl "http://127.0.0.1:33001/say?text=Hello&voice=betty" -o betty.mp3
```
**List available voices:**
```bash
curl http://127.0.0.1:3001/voices
curl http://127.0.0.1:33001/voices
```
## Customization
ttstoy/dectalk-server/TESTING.md
+15 -15
View File
@@ -6,15 +6,15 @@ Quick testing guide to verify everything works.
```bash
cd ~/Desktop/ttstoy/dectalk-server
PORT=3001 npm start
PORT=33001 npm start
```
You should see:
```
DECTalk TTS Server running on http://localhost:3001
Health check: http://localhost:3001/health
Simple API: http://localhost:3001/say?text=Hello
MiniMax-compatible API: POST http://localhost:3001/v1/t2a_v2
DECTalk TTS Server running on http://localhost:33001
Health check: http://localhost:33001/health
Simple API: http://localhost:33001/say?text=Hello
MiniMax-compatible API: POST http://localhost:33001/v1/t2a_v2
```
## Step 2: Test the API Directly
@@ -23,10 +23,10 @@ Open a new terminal and test:
```bash
# Test health check
curl http://127.0.0.1:3001/health
curl http://127.0.0.1:33001/health
# Test simple endpoint (saves to test.mp3)
curl "http://127.0.0.1:3001/say?text=Hello%20world" -o test.mp3
curl "http://127.0.0.1:33001/say?text=Hello%20world" -o test.mp3
# Play the audio
ffplay test.mp3
@@ -34,7 +34,7 @@ ffplay test.mp3
mpv test.mp3
# Test MiniMax-compatible endpoint
curl -X POST http://127.0.0.1:3001/v1/t2a_v2 \
curl -X POST http://127.0.0.1:33001/v1/t2a_v2 \
-H "Content-Type: application/json" \
-d '{"text": "Testing DECTalk compatibility", "voice_setting": {"voice_id": "default"}}' \
| jq '.base_resp'
@@ -53,7 +53,7 @@ Expected output:
In Discord:
```
[p]ttstoy dectalkurl http://127.0.0.1:3001
[p]ttstoy dectalkurl http://127.0.0.1:33001
[p]ttstoy mode dectalk
[p]ttstoy mode
```
@@ -61,7 +61,7 @@ In Discord:
You should see:
```
Current TTS Mode: 🤖 DECTALK
DECTalk API URL: http://127.0.0.1:3001
DECTalk API URL: http://127.0.0.1:33001
```
## Step 4: Test TTS in Discord
@@ -88,21 +88,21 @@ The bot should mix DECTalk voice with sound effects.
### Server won't start (port in use)
```bash
# Find what's using port 3001
lsof -i :3001
# Find what's using port 33001
lsof -i :33001
# Use a different port
PORT=3002 npm start
PORT=33002 npm start
# Update TTSTOY
[p]ttstoy dectalkurl http://127.0.0.1:3002
[p]ttstoy dectalkurl http://127.0.0.1:33002
```
### "Cannot reach DECTalk API"
1. Check server is running:
```bash
curl http://127.0.0.1:3001/health
curl http://127.0.0.1:33001/health
```
2. Check server logs in the terminal where you started it
ttstoy/dectalk-server/VOICES.md
+1 -1
View File
@@ -49,7 +49,7 @@ Voice commands:
# 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"
curl "http://127.0.0.1:33001/say?text=Hello%20I%20am%20$voice&voice=$voice" -o "${voice}.mp3"
done
```
ttstoy/dectalk-server/server.js
+1 -1
View File
@@ -17,7 +17,7 @@ const path = require('path');
const crypto = require('crypto');
const app = express();
const PORT = process.env.PORT || 3000;
const PORT = process.env.PORT || 33001;
const OUTPUT_DIR = process.env.OUTPUT_DIR || path.join(__dirname, 'output');
// Ensure output directory exists
ttstoy/morshu-server/server.py
+2 -2
View File
@@ -1,7 +1,7 @@
#!/usr/bin/env python3
"""
Morshu TTS Server — standalone HTTP API for MorshuTalk engine.
Runs on port 3002. GET /say?text=... returns WAV audio.
Runs on port 33002. GET /say?text=... returns WAV audio.
"""
import os
import sys
@@ -18,7 +18,7 @@ sys.path.insert(0, str(TTSTOY_DIR))
from morshutalk_engine import Morshu
morshu = Morshu()
PORT = int(os.environ.get("PORT", 3002))
PORT = int(os.environ.get("PORT", 33002))
class Handler(BaseHTTPRequestHandler):
ttstoy/ttstoy.py
+3 -3
View File
@@ -344,7 +344,7 @@ class TtsToy(Cog):
sfx_volume=100,
tts_mode="minimax",
chatterbox_api_url=CHATTERBOX_DEFAULT_URL,
dectalk_api_url=f"http://127.0.0.1:3001",
dectalk_api_url=f"http://127.0.0.1:33001",
dectalk_auto_start=True,
accessibility_mode=False,
vox_pack="vox",
@@ -688,7 +688,7 @@ class TtsToy(Cog):
text: Text to synthesize
audio_path: Output file path
"""
morshu_url = "http://127.0.0.1:3002"
morshu_url = "http://127.0.0.1:33002"
try:
r = requests.get(f"{morshu_url}/say", params={"text": text}, timeout=60)
r.raise_for_status()
@@ -1970,7 +1970,7 @@ class TtsToy(Cog):
Show or set DECTalk API URL.
- `[p]ttstoy dectalkurl` → show current URL
- `[p]ttstoy dectalkurl http://127.0.0.1:3001` → set URL
- `[p]ttstoy dectalkurl http://127.0.0.1:33001` → set URL
"""
if url is None:
current = await self._get_dectalk_api_url()
ttstoy/webui/app.py
+4 -4
View File
@@ -172,7 +172,7 @@ def get_chatterbox_url() -> str:
def get_dectalk_url() -> str:
cfg = get_global_config()
return cfg.get("dectalk_api_url", "http://127.0.0.1:3001")
return cfg.get("dectalk_api_url", "http://127.0.0.1:33001")
# ---------------------------------------------------------------------------
@@ -403,7 +403,7 @@ def api_tts_generate():
# Direct server modes — generate audio without the bot
if mode == "morshu":
try:
r = requests.get("http://127.0.0.1:3002/say", params={"text": text}, timeout=60)
r = requests.get("http://127.0.0.1:33002/say", params={"text": text}, timeout=60)
r.raise_for_status()
job_id = str(uuid.uuid4())
out_path = tempfile.mktemp(suffix=".wav")
@@ -416,7 +416,7 @@ def api_tts_generate():
if mode == "dectalk":
try:
dectalk_url = gcfg.get("dectalk_api_url", "http://127.0.0.1:3001")
dectalk_url = gcfg.get("dectalk_api_url", "http://127.0.0.1:33001")
r = requests.get(f"{dectalk_url}/say", params={"text": text}, timeout=30)
r.raise_for_status()
job_id = str(uuid.uuid4())
@@ -680,7 +680,7 @@ def api_mc_tts():
return r.content, 200, {"Content-Type": "audio/wav"}
elif mode == "morshu":
r = requests.get("http://127.0.0.1:3002/say", params={"text": text}, timeout=60)
r = requests.get("http://127.0.0.1:33002/say", params={"text": text}, timeout=60)
r.raise_for_status()
return r.content, 200, {"Content-Type": "audio/wav"}
ttstoy/webui/templates/dectalk.html
+1 -1
View File
@@ -8,7 +8,7 @@
<div class="card">
<h2>About</h2>
<div style="font-size:0.85rem;color:#b0c8e0;margin-bottom:0.5rem;">Classic 1980s robotic speech synthesizer. Voices are controlled inline using commands embedded in your text.</div>
<div class="muted">Server URL: <code>{{ gcfg.get('dectalk_api_url', 'http://127.0.0.1:3001') }}</code></div>
<div class="muted">Server URL: <code>{{ gcfg.get('dectalk_api_url', 'http://127.0.0.1:33001') }}</code></div>
</div>
<div class="card">