# 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)