BetterPlayer

An open-source music bot for Discord written in Java.

You can add BetterPlayer to your Discord server by going to https://join.betterplayer.net, alternatively you can choose to host your own instance of BetterPlayer

If you want to use the Beta version of BetterPlayer, or have a second instance of BetterPlayer available in your server, you can add BetterPlayer Canary at https://canary.betterplayer.net

Commands

The default prefix is $. To see a list of all commands, their shorthands and what they do use $help in a channel where BetterPlayer can send and receive messages

Running BetterPlayer yourself

Requirments:

• Runtime which can run Docker containers
• MySQL Database
• API Key for the YouTube Data API
• Discord Bot token

A prebuild image is available at docker-registry.k8s.array21.dev/betterplayer-bot, only the latest tag is supported for now.

Environmental variables

Required

• BOT_TOKEN Your Discord bot token
• GOOGLE_API_KEY Google API key, required regardless of the value of 'USE_GOOGLE_API'
• DB_HOST Your database host
• DB_DATABASE The name of the database
• DB_USERNAME Username for logging into the database
• DB_PASSWORD Password for logging into the database

Optional

• USE_GOOGLE_API Whether to use the Google APIs for search or use the YouTube Music frontend, defaults to using the API (true)
• KSOFT_API_TOKEN Your KSoft.Si API token, required for using the lyrics command

Progress

You can find what is being worked on here

Dependencies

• JDA
• Guava
• SLF4j
• LavaPlayer
• org.json
• Gson
• commons-lang3
• httplib
• JDBD