53 lines
2.1 KiB
Markdown
53 lines
2.1 KiB
Markdown
# 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)
|