Discord Player v8
Queues, playback controls, and source plugins for Discord music bots, with audio handled by Remedia.
Development preview
v8 is in development and its API can still change. The stable release is documented in v7.
Discord Player manages queues, playback controls, and events for Discord music bots. Remedia decodes audio and sends it over Discord voice, either inside your bot process or on a separate server.
Get started
Generate a bot with one command and play your first track.
Guides
Queues, controls, events, voice, filters, and crossfade.
Migrate from v7
Update an existing music bot.
API reference
Methods, options, and event arguments.
What you need
| Requirement | Details |
|---|---|
| Runtime | Node.js 22.18 or newer, ESM |
| Discord bot | Any gateway library. The tutorial uses discord.js |
| Source plugin | Turns a query into tracks and audio. The generated bot includes one |
| FFmpeg 9 | Shared libraries on the machine that runs the audio engine. See FFmpeg |
How the pieces fit
View Mermaid source
flowchart LR
Bot["Your bot<br/>(commands, gateway)"] --> Player["Discord Player<br/>(queues, plugins)"]
Player --> Remedia["Remedia<br/>(decode, voice)"]
Remedia --> Discord["Discord voice"]Your bot owns the Discord connection and commands. Discord Player owns tracks, queues, and source plugins. Remedia owns decoding and voice transport. The architecture section covers the details.
Where to go next
| I want to | Read |
|---|---|
| Build my first bot | Getting started |
| Add it to an existing bot | Manual setup |
| Add a music provider | Source plugins |
| Run audio on another machine | Remote playback |
| Upgrade a v7 bot | Migration guide |
| Look up a method or event | API reference |
Continue reading
Build your first music bot