Mixer is a lightweight audio mixer for Discord bots using @discordjs/voice. It allows you to play multiple audio streams simultaneously with individual stream attribute control.

• Join voice channel and play raw PCM audio
• Mix multiple sources into one output
• Per-stream volume control
• Auto cleanup after playback

npm install @wetalabs/mixer

const { joinVoiceChannel } = require("@discordjs/voice");
const Mixer = require("@wetalabs/mixer");

const mixer = new Mixer();

const connection = joinVoiceChannel({
  channelId: voiceChannel.id,
  guildId: guild.id,
  adapterCreator: guild.voiceAdapterCreator,
});

mixer.attachConnection(connection);

await mixer.playSound("intro", "./sounds/intro.mp3", 0.8);

mixer.resetAll();
connection.destroy();

Attaches an existing Discord voice connection to the mixer. Must be called before playing any sounds.

• Params:

  • connection: A valid voice connection object from @discordjs/voice.

Detaches the current voice connection and stops playback. Does not destroy the connection.

Plays a sound from the given file path with a unique ID and optional volume. Requires attachConnection() to be called first.

• Params:

  • soundId: A unique identifier for the sound.
  • filePath: Path to a valid audio file.
  • volume? (optional): A number between 0.0 and 1.0 (default is 1.0).

Stops and removes a currently playing sound by its ID.

• Params:

  • soundId: The ID of the sound to stop.

Changes the volume of a currently playing sound.

• Params:

  • soundId: The ID of the sound.
  • volume: A number between 0.0 and 1.0.

Stops all currently playing sounds and resets the mixer state. Note: This does not disconnect the voice connection - use detachConnection() for that.

Mixer extends EventEmitter and emits events you can hook into:

MIT