Embedded playback

Embedded mode is the simplest setup. @remedia/client calls the native engine in @remedia/node directly, and no server or WebSocket is involved.

import { Player } from 'discord-player';

const player = new Player({
  nodes: [{ id: 'local', type: 'embedded', capacity: 8 }],
  send,
});

await player.initialize(botUserId);

capacity is how many guild sessions the node accepts. The default is 64.

Set upCopy Anchor Link

1. Use Node.js 22.18 or newer with ESM.
2. Install discord-player and @remedia/node.
3. Install the FFmpeg 9 shared libraries on the bot machine. The ffmpeg executable alone is not enough.
4. Allow optional platform packages during installation, so the native binary for your platform is installed.
5. Run the smoke test.

What embedded nodes allowCopy Anchor Link

Because the engine runs in your process, a source plugin can return a local encoded Readable or a buffer. A remote node cannot use those.

Plan capacityCopy Anchor Link

Each active guild has its own playback and voice session. Size capacity from measured CPU and memory use with your codecs, filters, and crossfade, not from how long queues are.

Shut down cleanly so the native sessions are released:

await player.destroy();

CrossfadeCopy Anchor Link

Set crossfade on the Player or a queue. Embedded sessions receive the setting directly. See crossfade.