Play10

This is a discord bot to play music from Youtube, a feature that was removed from others bots during the great purge in 2021.

Commands

• /join : make the bot join the voice channel
• /play : make the bot play the music specified in the url. If you try to play another music while one is already playing, it will place the music into the queue to be played next
• /next : play the next music in the queue
• /pause : pause the music
• /resume : resume the music
• /stop : stop the music and clear the queue
• /what : display the name of the music currently playing and the channel from where it came from
• /list : list the music in the queue
• /ping : the bot should respond "Pong!", just to test if the bot is working

Acknowledgements

This bot is intended to be a private bot you can add to a server you own. You can copy and host it by yourself if you want.

Deployment

Neither of these solution provide the ".env" file required to run the bot. You have to either create the file at the root of the project folder and add these lines:

BOT_TOKEN="your_bot_token"
CLIENT_ID="your_bot_client_id"
GUILD_ID="your_server_id"

or manually input the variables in the run command or the compose file (discouraged for security reasons).

• You also need to add a file cookies.json at the root folder of the project. This file should store you cookies of your Youtube account so the bot is considered as a user and it allows it to stream audio. You may need to change it from time to time.

Notes:

• both "BOT_TOKEN" and "CLIENT_ID" are required and can be found at "https://discord.com/developers/applications/$CLIENT_ID$"
• the GUILD_ID is used to import the commands to your server and is optional, but recommended.

Docker deployment by pulling the image from Dockerhub with "docker-compose.yml"

Use the "docker-compose.yml" to deploy the container. This will, by default:

• pull the latest version of the bot
• name the container "play10"
• automatically restart the container, unless stopped manually
• expose port 3000 both externally and internally (3000:3000)
• seek the environment variable in the ".env" file
• create a volume to store the commands logs (content can be found by default at "/var/lib/docker/volumes/play10_logs/_data") If you deploy the container using an external too (such as Portainer stack, etc), make sure to upload the ".env" file to the stack

Docker deployment by building locally

1: copy the project folder to "/usr/src/app/Play10" (or any other folder of your choice) 2: cd "/usr/src/app/Play10" 3: docker build -t unlimitedrulebook/play10:latest ./ 4: run the container via the compose file provided: docker-compose -f docker-compose.yml up

Manual deployment

1: Clone this repository. 2: go inside the folder "Play10" and run npm install 3: make sure to have the ".env" file created and filled with the correct informations 4: in the terminal, inside the "Play10" folder, run

npm run deploy-commands.

This will import the commands to your server. Once again, make sure that you have filled the GUILD_ID environment variable from the previous step. 5: (optional) if you want to test the bot locally, run npm run devStart. It will start the bot in your machine, and you can then play with it from your own discord server.

Add the bot to your server

Assuming the application is private, you will have to be both the owner of the bot and the server. Modify the "$CLIENT_ID$" and follow this link: https://discordapp.com/oauth2/authorize?&client_id=$CLIENT_ID$&scope=bot&permissions=8 From there, follow the instructions on screen

Contributing

Any contribution to make the bot better is appreciated 😉.