MaBalls is an open-source discord music bot. It is designed to work with YouTube primarily but should work with any non-DRM media.
We used yt-dlp to parse media and discord.py to communicate with the discord API.
We host a bot that runs our master branch - its join URL is here.
Python 3.10 or higher is required
Requirements are listed inside the requirements.txt file.
The main file is musS_D.py
If you're new to this, don't worry! We have* an in-depth install guide here.
*The guide has yet to be written. The link takes you to one of the sites on the internet of all time.
There are cogs available that can be enabled and disabled at will in order to add extensibility to the bot.
All but Update are needed for core functionality.
They can be enabled and disabled via the .env with respective keys.
The Update cog is disabled by default, and when enabled allows a user specified in the developers key of the .env file to run
the /update command; which automatically update the bot's libraries to ensure functionality of yt-dlp.
To enable the Update cog, change the corresponding value in the .env to "true".
However, this command only works on linux systems and requires the bot to be
currently running in a tmux session and a python virtual environment
Out of the box, the bot will search for a Discord token in the .env named key.
key="aaaaaaaaaaaaaaaaaaaaaaaaaa.bbbbbb.cccccccccccccccccccccccccccccccccccccc"The bot will also search for a list called developers, be sure to put your username in that list if you want to have
full control of the bot.
developers=111111111111111111,222222222222222222,333333333333333333For a complete example, check the example_env file.