music-bot
music-bot copied to clipboard
The only self-hostable discord music bot you will ever need, has a cool website too ✌️
Project overview
As a core contributor to discord-player, I've dedicated significant time and effort to this project. My familiarity with the core principles of discord-player has allowed me to incorporate many of its concepts and best practices into this project, serving as a valuable reference for library users. I've strived to ensure the project is user-friendly and intuitive. Your suggestions and feedback are always welcome - feel free to open an issue or submit a pull request.
Music Bot
A complete example of a discord music bot including database, web dashboard, and more powered by discord.js and discord-player.
Features
- Easy to use
- Customizable
- Covers most of the concepts as well as best practices of discord-player
- Slash commands
- Web dashboard
- Custom playlists management
- Queue management
- Persistent configurations
- Equalizer
and more...
Setting up the bot
Setup with Docker
- TODO
Manual setup
- Run
pnpm install --frozen-lockfileto install all dependencies
Starting the bot
- Rename
.env.exampleto.envand fill out the values - Put your bot token in
DISCORD_TOKEN - Put mongodb database credentials in
DATABASE_URL(You can get one for free from Mongodb Atlas) - Put your redis config in
REDIS_*(you can use memurai for windows) - Run
pnpm bot devto start the bot in development mode
Starting the website
- Rename
.env.exampleto.envand fill out the values - Run
pnpm run --filter web devto start the website in development mode
You can now use /web command to get magic link to the website. You are able to add songs to the queue, skip songs, change volume and more from the website itself. You can also do this from Discord using slash commands.

Support me on Patreon
If you like this project, consider supporting me on Patreon. This will help me to keep working on projects like this and make them even better.
