Skip to content
Projects

Androz2091/discord-player has 638 GitHub stars and 196 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 04:34 UTC. Last push 2026-11-14.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

🎧 Complete framework to simplify the implementation of music commands using discord.js v14

Creative & Media

README.md

Original

Discord Player

Discord Player is a music framework for Discord bots. Manage queues, tracks, playback, filters, and events while Remedia handles audio and Discord voice.

This README describes the v8 development branch. For v7, use the documentation matching your installed version.

Install

Node.js 22.18+ and ESM are required. To start a new bot, generate a project:

npm create music-bot@dev my-bot

To add Discord Player to an existing project, install the dev tag (npm's latest is still v7). For embedded playback:

pnpm add discord-player@dev discord.js @remedia/node

Install FFmpeg 9 shared libraries on the machine running audio. Remote-only bot processes do not need FFmpeg locally.

Create a player

import { Client, Events, GatewayIntentBits } from 'discord.js';
import { Player } from 'discord-player';
import { directMedia } from './direct-media.js';

const client = new Client({
  intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildVoiceStates],
});

const player = new Player({
  nodes: [{ id: 'local', type: 'embedded' }],
  plugins: [directMedia()],
  send(guildId, packet) {
    const guild = client.guilds.cache.get(guildId);
    if (!guild) throw new Error('Guild unavailable');
    return guild.shard.send(packet);
  },
});

client.on('raw', (packet) => player.receive(packet));
client.once(Events.ClientReady, (ready) => {
  void player.initialize(ready.user.id).catch(console.error);
});

The directMedia plugin is defined in the manual setup tutorial. Source plugins supply playable audio. Discord Player does not automatically register a music provider.

Inside your play command, after initialization:

const result = await player.play({ guildId, channelId }, 'https://your-media-host.example/song.mp3');
if (result.track) console.log('Playing', result.track.title);

Replace the example URL with a real audio file.

Playback controls

const queue = player.getQueue(guildId);
if (queue) {
  await queue.node.pause();
  await queue.node.resume();
  await queue.node.setVolume(70);
  await queue.skip();
}

Documentation