Package Exports
- discord-player
- discord-player/dist/index.js
- discord-player/dist/index.mjs
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (discord-player) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
Discord Player
Discord Player is a powerful framework for JavaScript and TypeScript, built on top of @discord.js/voice library. It provides easy set of customizable tools to develop Discord Music bots.
Why Discord Player?
- Beginner friendly, easy to understand
- TypeScript support
- Supports audio player sharing
- Quick and easy to set up
- Wide range of player management features
- 64+ built-in audio filter presets
- Highly customizable
- Automatic queue management
- Query caching support
- Wide range of extendable sources via Extractors API
- Object oriented
- Built in stats tracker
Installation
Before you start
Discord Player requires Discord.js 14.0 or higher. PLease make sure you have a compatible version using npm list discord.js in your terminal. If you're using an earlier version please update it. The Discord.JS Guide has resources to help with that.
Main Library
$ yarn add discord-player # main library
$ yarn add @discord-player/extractor # extractors providerDiscord Player recognizes
@discord-player/extractorand loads it automatically by default.
Opus Library
Discord Player is a high level framework for Discord VoIP. Discord only accepts opus packets, thus you need to install opus library. You can install any of these:
$ yarn add @discordjs/opus
# or
$ yarn add opusscriptFFmpeg or Avconv
FFmpeg or Avconv is required for media transcoding. You can get it from https://ffmpeg.org or by installing it from npm (ffmpeg-static or other binaries are not recommended):
$ yarn add ffmpeg-static
# or
$ yarn add @ffmpeg-installer/ffmpeg
# or
$ yarn add @node-ffmpeg/node-ffmpeg-installer
# or
$ yarn add ffmpeg-binariesUse
FFMPEG_PATHenvironment variable to load ffmpeg from custom path.
Streaming Library
You also need to install streaming library if you want to add support for youtube playback. You can install one of these libraries:
$ yarn add ytdl-core
# or
$ yarn add play-dl
# or
$ yarn add @distube/ytdl-coreDone with all these? Let's write a simple music bot then.
Setup
Let's create a master player instance.
const { Player } = require('discord-player');
// get some extractors if you want to handpick sources
const { SpotifyExtractor, SoundCloudExtractor } = require('@discord-player/extractor');
const client = new Discord.Client({
// Make sure you have 'GuildVoiceStates' intent enabled
intents: ['GuildVoiceStates' /* Other intents */]
});
// this is the entrypoint for discord-player based application
const player = new Player(client);
// This method will load all the extractors from the @discord-player/extractor package
await player.extractors.loadDefault();
// If you dont want to use all of the extractors and register only the required ones manually, use
await player.extractors.register(SpotifyExtractor, {});
await player.extractors.register(SoundCloudExtractor, {});Did You Know? Discord Player is by default a singleton.
Now, let's add some event listeners:
// this event is emitted whenever discord-player starts to play a track
player.events.on('playerStart', (queue, track) => {
// we will later define queue.metadata object while creating the queue
queue.metadata.channel.send(`Started playing **${track.title}**!`);
});Let's write the command part. You can define the command as you desire. We will only check the command handler part:
async function execute(interaction) {
const channel = interaction.message.member.voice.channel;
if (!channel) return interaction.reply('You are not connected to a voice channel!'); // make sure we have a voice channel
const query = interaction.options.getString('query', true); // we need input/query to play
// let's defer the interaction as things can take time to process
await interaction.deferReply();
try {
const { track } = await player.play(channel, query, {
nodeOptions: {
// nodeOptions are the options for guild node (aka your queue in simple word)
metadata: interaction // we can access this metadata object using queue.metadata later on
}
});
return interaction.followUp(`**${track.title}** enqueued!`);
} catch (e) {
// let's return error if something failed
return interaction.followUp(`Something went wrong: ${e}`);
}
}That's all it takes to build your own music bot.
Check out the Documentation for more info.
Community Resources
A curated list of resources (such as open source music bots, extractors, etc.) built by Discord Player community. https://discord-player.js.org/docs/guides/community-resources