Guide
Everything you need to get Voice Party running in your server.
Setup
1. Add the bot
Click the Add to Server button on the home page and select your server. The bot requires these permissions:
- View Channels and Connect to see and join voice channels
- Speak to play notification tones during recording
- Send Messages and Read Message History to post stats and respond to commands
- Use Voice Activity to detect when users are speaking
No privileged intents (Message Content, Presence, Server Members) are required.
2. Configure settings
Run /settings to open the settings panel. The default configuration tracks stats automatically when someone joins a voice channel. Recording is disabled by default.
3. Start a session
With the default settings, the bot automatically joins and starts tracking when someone enters a voice channel. You can also manually start a session with /join-voice.
Settings
Open settings with /settings. The panel has three pages: General, Recording, and Clips.
General
Auto-start
Automatically start tracking stats when someone joins a voice channel. On by default.
Manager Role
Designate a role that can use management commands (start/stop recording, join voice, change settings). Server admins and the owner always have access regardless of this setting.
Manage settings
Allow the manager role to change settings (except the manager role itself, which only admins can change). Off by default. Requires a manager role to be set.
Ignore bots
Exclude other bots from stats and tracking. The Voice Party bot itself is always excluded. On by default.
Recording
Recording
Master toggle for voice recording. All other recording settings depend on this. Off by default.
Auto-record
Automatically start recording when a session begins. If off, use /start-recording manually. Requires recording to be enabled.
Require consent
When on, users must explicitly allow recording before their audio is captured. When off (default), users are recorded automatically and informed with the option to opt out.
Event log
Include a timestamped event log file (joins, leaves, mutes, etc.) alongside the recording. On by default.
Clips
Clips
Enable the clips feature, allowing users to capture short audio snippets from voice. Off by default.
Create Role
Restrict who can create clips to a specific role. If not set, everyone can create clips.
Play Role
Restrict who can play clips to a specific role. If not set, everyone can play clips.
Commands
| Command | Description | Who can use it |
|---|---|---|
/join-voice |
Start a voice party in your current voice channel. If a session is active elsewhere, prompts to switch. | Managers |
/start-recording |
Begin recording the current session. Users are notified. | Managers |
/stop-recording |
Stop the active recording. Stats tracking continues. | Managers |
/stats |
View live stats for the current session (speaking leaderboard, awards so far). | Everyone |
/ignore-me |
Toggle your opt-out status. Choose to ignore recording only or all tracking entirely. | Everyone |
/settings |
Open the server settings panel. | Managers |
/clip create |
Capture a clip from the last 3-20 seconds of voice audio. | Create Role / Everyone |
/clip play |
Play a saved clip in your current voice channel. | Play Role / Everyone |
/clip list |
View all saved clips with play and delete buttons. | Everyone |
/voiceparty |
About Voice Party, useful links, and global opt-out. | Everyone |
Clips
Clips let you capture short audio moments from voice and save them to play back later. Each server can store up to 2 clips.
How it works
When clips are enabled, the bot keeps a rolling 20-second audio buffer in memory for each user in the voice channel. When someone runs /clip create seconds:10, the bot captures the last 10 seconds of audio from all speakers and prompts for a name.
Clips are saved and persist until deleted. Anyone who was speaking in a clip (or the creator) can delete it.
Playing clips
Use /clip play name to play a clip. If the bot is already in the voice channel (during a session), it plays through the existing connection. Otherwise, it joins temporarily to play the clip and then leaves.
Permissions
Voice Party has three permission levels:
Admin
Server owner, or anyone with Administrator or Manage Server permission. Full access to everything including setting the manager role.
Manager
Anyone with the configured manager role (plus all admins). Can use /join-voice, /start-recording, /stop-recording, and /settings. Can edit settings only if the admin enables it.
Everyone
Can use /stats, /ignore-me, and /voiceparty.
FAQ
The bot can't see my voice channel
Make sure the bot has View Channel and Connect permissions for the channel. When you run /join-voice and the bot can't find you, it will offer to list all channels it can currently see.
How does the session end?
A session ends when all participants leave the voice channel. There is a 10-second grace period in case someone disconnects briefly. Managers can also end a session by switching to a new channel with /join-voice.
What happens to my data?
All session data (stats, audio, events) is temporary and deleted when the session ends. Recordings are delivered to the channel as files and then removed. Clips are stored until manually deleted. See the privacy policy for full details.
What happens if the bot is removed from my server?
If Voice Party is removed from your server, all saved clips and server settings are automatically deleted after 7 days. If the bot is re-added within that window, your data is preserved. After 7 days, everything is permanently removed.