Documentation
Getting started
Groupie joins your voice channel and reads messages from a text channel aloud in each user's chosen voice. Preferences follow your Discord account across servers.
Invite & permissions
In the Discord Developer Portal, generate an invite with scopes bot and applications.commands. Grant Connect, Speak, Use Voice Activity, Send Messages, and Read Message History. Enable the Message Content Intent under Bot settings.
Quick setup
- Join a voice channel, then run
/join. - Set your voice with
/set voice(autocomplete lists installed voices). - An admin sets the TTS text channel with
/set channel. - Chat in that text channel — Groupie reads messages aloud in voice.
- Optional: set a display alias with
/set aliasso the bot greets your lines by name.
Voice engines
Piper is the default (free, local). Optional providers include Kokoro, Qwen3-TTS, and ElevenLabs when configured on the host running the bot. Download Piper voice models before using a voice ID — they are not bundled with the bot.
Commands
| Command | Description |
|---|---|
| /join | Bot joins your voice channel |
| /leave | Bot leaves voice |
| /set voice | Choose your TTS voice |
| /set channel | Set the text channel for TTS (admin) |
| /set alias | Custom name read before your messages |
| /my voice | Show your current voice |
| /toggle read_names | Read “Name said: …” prefix (admin) |
| /mute | Block a user from the bot (moderator) |
| /unmute | Restore a muted user (moderator) |
| /premium check | Check premium status |
| /premium add | Manual premium list (owner/admin) |
| /premium remove | Remove from manual premium list |
Tips
- Groupie auto-leaves when alone in a voice channel.
- Per-user voice and alias settings persist across servers.
- Slash commands can take up to an hour to appear globally; guild-scoped sync may be faster for test servers.