Files
scrapyard-cogworks/ttstoy
kingston 6ed69bc686 ttstoy: remove all TTS server management commands from the bot
The dectalk, morshu, and vox servers are managed entirely by systemd now, so
the bot no longer needs to inspect or manage them. Removed the stop and status
commands for all three, the unused dectalk_auto_start config, and the dead
server directory and process attributes. The cog keeps only the fixed ports it
uses to reach the services over HTTP.
2026-09-14 14:46:09 -05:00
..
2026-06-05 16:41:55 -05:00
2026-06-05 16:41:55 -05:00
2026-06-05 16:41:55 -05:00
2026-06-05 16:41:55 -05:00
2026-06-05 16:41:55 -05:00
2026-06-05 16:41:55 -05:00
2026-06-05 16:41:55 -05:00
2026-06-05 16:41:55 -05:00
2026-06-05 16:41:55 -05:00
2026-06-05 16:41:55 -05:00

TTS Toy

A RedBot cog for text-to-speech in voice chat with multiple TTS engines, emoji sound effects, and voice cloning.

Modes

Mode Description Requires
minimax MiniMax cloud API, natural voices API key
chatterbox Local Chatterbox server, AI voice cloning Chatterbox server
dectalk Classic 1980s robotic voice DECTalk server
morshu Morshu from CD-i Zelda g2p_en, numpy, pydub
vox Black Mesa VOX announcer Built-in

Switch modes: [p]ttstoy mode <mode>

Quick Start

[p]ttstoy mode chatterbox
[p]chatterbox addvoice MyVoice          (attach .wav/.mp3 or paste a URL)
[p]tts Hello world [laugh] this is cool

Commands

Use [p]ttstoy to see all available commands for the current mode.

Chatterbox Voice Management

Command Description
[p]chatterbox addvoice <name> Upload a voice clip (attach file or paste URL)
[p]chatterbox removevoice <name> Remove a voice and delete from server
[p]chatterbox sharevoice <name> @User Share a voice with another user
[p]chatterbox myvoices List your voices
[p]chatterbox temp [0.0-1.5] Per-voice randomness (per voice per user)
[p]chatterbox exag [0.25-2.0] Per-voice expressiveness (per voice per user)
[p]chatterbox volume [-20-20] Per-voice dB loudness offset (per voice per user)
[p]chatterbox guide Full feature guide
[p]chatterbox model [turbo|original] Switch Chatterbox model (owner)
[p]chatterbox url [url] Set Chatterbox server URL (owner)

Append reset to temp, exag, or volume to clear the setting.

General

Command Description
[p]tts <text> Speak in voice chat
[p]ttstoy myvoice [name] Set or view your personal voice
[p]ttstoy voice [name] Set global default voice (owner)
[p]ttstoy mode [mode] Show or set TTS mode (owner)
[p]ttstoy sfxvolume [0-100] Set SFX volume (owner)
[p]sfx List available sound effects
[p]ttstoy info DM setup instructions

DECTalk

Command Description
[p]ttstoy dectalkinstall Install built-in DECTalk server
[p]ttstoy dectalkstart Start server
[p]ttstoy dectalkstop Stop server
[p]ttstoy dectalkstatus Check server status
[p]ttstoy dectalkautotoggle Toggle auto-start
[p]ttstoy dectalkurl [url] Set DECTalk API URL

DECTalk voices are controlled in-text: [:np] Paul, [:nb] Betty, [:nh] Harry, [:nf] Frank, [:nd] Dennis, [:nk] Kit, [:nu] Ursula, [:nr] Rita, [:nw] Wendy.

VOX

Command Description
[p]ttstoy voxpack [vox|vox2] Switch VOX voice pack
[p]ttstoy voxwords List available words

Emoji SFX

Include emoji in your TTS text to trigger sound effects:

[p]tts Hello 🎉 world 🔥

Use [p]sfx to see all available triggers. Add .mp3 files to sfx/<folder>/ to customize.

Requirements

  • RedBot 3.5+
  • Audio cog loaded
  • ffmpeg
  • requests, g2p_en, numpy, pydub (pip)