Files
scrapyard-cogworks/.ai-context.md
T

2.1 KiB

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