StageMusicBot

This bot is made to sit in a Stage Channel, and play music from your local machine 24/7, simple as that!

Looking to run this on replit? Check the replit branch!

How to Install:

Please try to follow these instructions first, if find that there is something you are unsure about, feel free to contact me on Discord (https://discord.gg/qBq2WSsgvv) or open an issue, and I'll be more than happy to help.

There are a few requirements needed before you can run this bot, run the command below to install these pre-requisites:

Windows:

py -m pip install -r requirements.txt

Linux:

python3 -m pip install -r requirements.txt

After that, you're good to begin configuration!

Configuration

To configure your bot fill in the information in config.py

• token = Your bot token from https://discord.com/developers/applications
• prefix = Your chosen bot prefix
• bot_id = The USER_ID of your bot
• stage_name = The name of the stage channel you wish for the bot to join. NOTE: this is CaSe sensitive
• mod_role = The name of the role you wish to allow to run join or close. NOTE: this is CaSe sensitive
• volume = The volume that the bot will play at (from 0 - 1 as a float/decimal), NOTE: It's at 0.2 by default for a reason, anything above that REALLY hurt
• guild_ids = The ID of the server your bot is running in, I know it's a list, but it just needs to be an INT in the list (Bot only runs in 1 server at this moment in time

To further configure your bot (optional) make a copy of albumart.json.example, and fill in the information with the supplied ones as a guide:

{
    "album_name":"Link to album art",
    "album_name":"Link to album art"
}

WHEN INVITING THE BOT Ensure the bot has both bot scopes AND all Privileged Gateway Intents

Import your songs

To import your songs, it's simple! Put all your music into a folder called songs in the same directory as the program, and it'll automatically read them from there! (Please note, the "now playing" command reads from ID3 tags, so these will need to be filled out for that command to pull information. I suggest using mutagen for this)

Contributing

Pull requests are welcome. For major changes, please open an issue the first to discuss what you would like to change.