Skip to content

Yaf707/VoiceChatUtilities

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VoiceChatUtilities

Premium voice-channel utility panel for Vencord / Equicord.

VoiceChatUtilities adds a clean Discord-style voice control panel for selecting members across voice channels and running common moderation or room-management actions quickly.

Made by Yamach.


Important Notice

Unlike cosmetic client-side plugins, VoiceChatUtilities can run real voice moderation actions on a server when your account has the required Discord permissions.

Depending on your permissions, actions may:

  • Move members between voice channels
  • Mute members
  • Unmute members
  • Deafen members
  • Undeafen members
  • Disconnect members from voice

Use it responsibly and only on servers where you are allowed to moderate voice channels.


Features

Voice Tools Panel

Open a full voice management panel from the top toolbar or context menus.

The panel can show:

  • Members in the current voice channel
  • Members across all voice channels
  • Selected members only
  • Members saved in temporary selection memory
  • Offline or stale selected members
  • Previous voice rooms for restore actions

Selection Memory

Select members from different voice rooms and keep them in temporary memory until you clear it.

You can:

  • Select users from voice rows
  • Add users manually by User ID
  • Select visible members
  • Remove visible members
  • Invert visible selection
  • Clear selected members
  • Clean stale/offline selected members

Selection memory is useful when people are scattered across multiple rooms.


Quick Voice Row Button

Adds a small button beside each voice user.

It can be configured as:

  • Native subtle button
  • Icon-only button
  • Minimal badge
  • Icon + text
  • Pill style
  • Glass style
  • Yamach premium style

Supported icon sets:

  • Plus / Check
  • Bookmark
  • User
  • Pin
  • Star
  • Crown
  • Sparkle
  • Target
  • Shield

Top Toolbar Launcher

Adds a clean Voice Tools button to Discord’s top toolbar.

Options include:

  • Icon-only button
  • Icon + text button
  • Optional selected count badge

Pull Selected Members

Move selected members to a target voice channel.

Supported targets:

  • Your current voice channel
  • A selected voice channel from the panel
  • A voice channel from the channel context menu
  • A voice channel row button, if enabled

Distribute Selected Members

Distribute selected members across multiple voice rooms.

Distribution modes:

  • Round-robin: sends members evenly in order
  • Balanced: attempts to balance by current room size

You can select rooms manually or choose a whole category.


Restore Previous Rooms

Before moving selected members, the plugin remembers their previous voice rooms.

You can later restore selected members to their previous rooms.

The restore picker lets you choose exactly who to restore.


Bulk Voice Actions

Run voice moderation actions on selected users or on a channel.

Supported actions:

  • Pull selected
  • Distribute selected
  • Disconnect selected
  • Mute selected
  • Unmute selected
  • Deafen selected
  • Undeafen selected
  • Restore previous rooms

Channel context actions can also run on everyone in a voice channel, depending on your settings.


Current Channel Quick Actions

From a voice channel context menu, you can run actions on the current channel:

  • Disconnect everyone in the channel
  • Mute everyone in the channel
  • Unmute everyone in the channel
  • Deafen everyone in the channel
  • Undeafen everyone in the channel
  • Pull selected members to that channel

English and Arabic Support

The plugin supports:

  • English UI
  • Arabic UI
  • English settings labels
  • Arabic settings labels

You can switch language from plugin settings.


Settings

General

  • Panel/menu language
  • Settings language
  • Main visual style

Visual styles:

  • Clean
  • Discord-like
  • Premium

Panel

  • Default member source: current voice channel or all voice channels
  • Include yourself by default
  • Include bots by default
  • Clear selection after action
  • Close panel after action

Voice Row Buttons

  • Show select button beside voice users
  • Show pull-to-me button beside your own voice row
  • Show pull-selected button on voice channel rows
  • Button position
  • Button visibility
  • Icon pack
  • Button style
  • Button size
  • Selected style
  • Accent color

Accent colors:

  • Blurple
  • Gold
  • Emerald
  • Cyan
  • Pink
  • Red

Top Toolbar

  • Show top Voice Tools button
  • Top button style
  • Show selected count badge

Actions

  • Distribution mode
  • Execution mode
  • Actions per batch
  • Wait seconds between batches
  • Delay between actions
  • Confirm before actions

Execution modes:

  • Fast Batched: fastest, but can hit rate limits if abused
  • Safe Sequential: slower, but gentler

Recommended Settings

Clean Native Setup

Recommended for most users:

Top toolbar button style: Icon only
Quick button style: Native subtle
Quick button icon: Bookmark
Quick button visibility: Hover + keep selected users visible
Quick button size: Compact
Selected state: Outline
Visual style: Discord-like

Fast Actions Setup

Fastest mode:

Execution mode: Fast Batched
Actions per batch: 100
Wait seconds: 0
Delay between actions: 0 ms

If Discord returns 429 rate-limit errors, use safer values:

Execution mode: Safe Sequential
Actions per batch: 5-10
Wait seconds: 1-2
Delay between actions: 100-500 ms

Usage

Open the Panel

Use one of these methods:

  1. Click the top Voice Tools button.
  2. Right-click a voice channel and open Voice Tools.
  3. Right-click a user and open Voice Tools.
  4. Use the quick button beside voice users.

Select Members

You can select members by:

  • Clicking the quick select button beside voice users
  • Opening the panel and selecting visible members
  • Adding a User ID manually
  • Selecting a full visible list
  • Inverting current visible selection

Pull Selected Members

  1. Select members.
  2. Choose a target voice channel.
  3. Click Pull Selected.
  4. Confirm the action if confirmation is enabled.

Distribute Selected Members

  1. Select members.
  2. Choose two or more target rooms.
  3. Select distribution mode in settings.
  4. Click Distribute Selected.

Restore Previous Rooms

  1. Move selected members using the plugin.
  2. Open Restore Previous Rooms.
  3. Choose who to restore.
  4. Confirm the action.

Permissions

VoiceChatUtilities depends on Discord permissions.

Some actions may require permissions such as:

  • Move Members
  • Mute Members
  • Deafen Members
  • Disconnect Members
  • Manage voice-related moderation permissions

If an action fails, check:

  • Your server permissions
  • Role hierarchy
  • Discord rate limits
  • Whether the user is still in voice
  • Console errors

Troubleshooting

The panel opens but no members show

Try:

  1. Make sure you are inside a server.
  2. Make sure members are connected to voice.
  3. Switch scope between Current Room and All Rooms.
  4. Press Refresh.
  5. Reload Discord.

A voice action failed

Possible reasons:

  • Missing permission
  • Target user left voice
  • Role hierarchy prevents moderation
  • Discord returned a rate limit
  • Discord changed internal voice state structure

Check console for request errors.


Rate limit errors

If you see 429 errors:

  • Lower Actions per batch
  • Add wait seconds between batches
  • Use Safe Sequential mode
  • Avoid repeatedly running mass actions

Quick buttons do not appear

Try:

  1. Make sure Show select button beside each voice user is enabled.
  2. Hover over the voice user row.
  3. Switch quick button visibility to Always.
  4. Reload Discord.
  5. Disable other plugins that heavily modify the channel list.

Channel pull button does not appear

Try:

  1. Enable Show pull-selected button on voice channel rows.
  2. Hover the voice channel row.
  3. Try the other channel pull button position setting.
  4. Reload Discord.

File Structure

VoiceChatUtilities/
  index.tsx
  settings.ts
  selection.ts
  utils.ts
  types.ts
  i18n.ts
  styles.css
  components/
    VoiceControlModal.tsx
  README.md

Repository Upload Notes

When uploading to GitHub, upload the plugin files at the repository root:

VoiceChatUtilities/
  index.tsx
  README.md
  settings.ts
  styles.css
  components/

Do not upload the whole extracted folder as a nested directory like this:

VoiceChatUtilities/
  VoiceChatUtilities-v28/
    index.tsx
    README.md

GitHub only shows the README automatically when README.md is in the repository root.


Safety

This plugin is meant to help server moderators and trusted staff manage voice channels more efficiently.

Do not use it to harass users, disrupt servers, or spam moderation actions.

Use confirmation prompts and safe execution settings when managing large groups.


Version

Current uploaded build:

v28

This build focuses on:

  • Clean native UI
  • Hover quick buttons
  • Selection memory
  • Pull selected members
  • Distribute selected members
  • Restore previous rooms
  • English/Arabic UI
  • Fast batched execution mode
  • Safer channel group handling from recent versions

License

Choose a license before making the repository public.

Recommended:

MIT License

If the repository is private, you can leave the license empty until release.

About

Advanced voice channel tools for Vencord/Equicord with selection memory, member actions, drag controls, and bilingual UI

Topics

Resources

Stars

Watchers

Forks

Contributors