Guide

Everything you need to get Voice Party running in your server.

Setup Settings Commands Clips Recording Beeps Premium Permissions FAQ

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.

Radio playback requires a system ffmpeg binary on the host. Install ffmpeg or set FFMPEG_PATH to its absolute path before enabling Radio.

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 six pages: General, Recording, Clips, Radio, Privacy, and Premium.

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

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.

Recording delivery

Small recordings are delivered as voice-optimized MP3 attachments. Large recordings are posted as private download links available for 24 hours to Discord users included in the recording. If delivery fails, the bot keeps a local recovery copy for up to 24 hours.

Speaker normalization

Balances per-user volumes in the final recording by applying a fixed gain to each speaker's track (up to ±12 dB) so quiet and loud speakers sit closer in level. Off by default. Leave off if you prefer the raw levels, or if some speakers only make brief loud noises (a sneeze, a shout) with little other audio, since the gain is based on each user's loudest moment.

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.

Speaker normalization

Same as the recording setting, but applied to saved clips. Off by default. Since clips are short, a brief loud moment (sneeze, shout) from a mostly silent speaker can cause their track to be cut, so leave off if that matters.

Radio

Premium-only master toggle for playing curated audio in voice channels. Off by default.

Available stations

Multi-select list of stations managers can choose from with /radio play. All default stations are selected until changed.

Volume

Radio playback defaults to 75%. Managers can change it with /radio volume. This volume only applies to radio, not recording beeps.

Privacy

Recording beep frequency

How often the bot plays an audible tone while recording or clip buffering is active, so everyone in the channel knows audio is being captured. Choose 30, 60, 90, or 120 seconds. Default is 60 seconds. See Recording Beeps for details.

Remove all data and unauthorize app

Admin only. Immediately and permanently deletes every piece of stored data for this server (settings, clips, stored audio, any pending deletion, any redeemed premium key) and removes the bot from the server. A confirmation prompt is shown first. The data cannot be salvaged after confirming. Re-adding the bot later starts fresh with default settings.

Premium

Premium status

Shows whether this server is on Premium and the source of that Premium (Discord store subscription or a permanent key). If you are not Premium, a link to the store is shown. See Premium below for what's unlocked and how to subscribe.

Premium branding

When enabled on a Premium server, the bot uses a gold avatar in this server only. Toggles have no effect when Premium is not active.

Input premium key

Admin only. Opens a prompt to paste a permanent premium key issued directly by the developer. Redeeming binds the key to this server only — it cannot be transferred or reused elsewhere. If the server's data is removed, the key is deleted too.

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
`/radio play`	Play an enabled radio station in your current voice channel.	Managers / Premium
`/radio stop`	Stop the active radio stream.	Managers / Premium
`/radio now`	Show the active radio stream.	Managers / Premium
`/radio volume`	Set radio playback volume.	Managers / Premium
`/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.

Radio

Premium servers can enable Radio in /settings, choose which default stations are available, then use /radio play to stream curated 24/7 stations or generated ambience into a voice channel. Radio volume defaults to 75% and can be changed with /radio volume; recording notification beeps keep their normal volume. Managers can use /radio stop to end playback and /radio now to check what is playing.

Radio is disabled while recording or clip buffering is active so the required notification tones remain audible.

Recording Beeps

Whenever voice audio is being captured (either a recording is active, or clips are enabled and buffering is running), the bot plays a short audible tone in the voice channel so everyone present is aware. A tone plays when capture first starts and then repeats at the configured interval.

The interval is configurable on the Privacy settings page: 30, 60, 90, or 120 seconds (default 60). The tone cannot be disabled. If both recording and clip buffering are active, only one tone plays, not two.

Premium

Voice Party is free to use for everything core: stats, awards, recording, clip capture, opt-outs, settings, event logs. The only things locked behind Premium are features that cost real compute, network, or storage to run, so the free tier can stay sustainable forever. There is no trial gate, no feature crippling, no ads.

What Premium unlocks

20 saved clips per server instead of 2. Free-tier servers can still create and delete clips freely, but only the 2 oldest clips are playable.
Speaker normalization for recordings. Per-user gain balancing applied to the final mixed file.
Speaker normalization for clips. Same balancing applied to saved clips.
Curated radio playback. Managers can enable radio, choose available default stations, and stream audio into voice.
Premium branding. Gold avatar for the bot in your server.

What happens if Premium lapses

Once a month the bot sweeps all servers and revalidates Premium. If a server's Premium ends (subscription cancelled, key revoked), the bot automatically:

Turns off both speaker normalization settings.
Stops any active radio stream and disables Radio.
Turns off premium branding and reverts the avatar.
Leaves saved clips in place, but only the 2 oldest remain playable. Clips 3 through 20 stay visible in /clip list and can still be deleted by their creators, speakers, or admins, so you never lose data.

Re-subscribing at any time immediately restores full access to all existing clips.

How to subscribe

Open the Premium tab inside /settings and use the store link shown there. The link opens Discord's in-app store page for Voice Party.

Mobile note: Discord's in-app monetization store is not available inside the Discord mobile app. If you're on a phone or tablet, open the store link in your phone's regular web browser (Safari, Chrome, etc.) and sign in to Discord there. The subscription will apply to your Discord account as normal once purchased.

Permanent keys

The developer can also issue a permanent premium key directly (for example, to partners, contest winners, or early supporters). A key is a single-use code that binds to exactly one server the first time it is redeemed — it cannot be shared, transferred, or used in multiple servers. To redeem one, go to the Premium tab in /settings, click Input key, and paste it in. If the server's data is ever removed from the bot, the key is deleted as well.

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, /radio, 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.