Usage

Usage For Beginners (Windows/Powershell)

Courtesy of Discordian#1891

1. Download and install the latest version of python from(https://www.python.org/downloads/)

   • Guide

2. Click the green Clone or download button and select download zip

   • Extract the Zip file to somewhere Easily Findable

3. Open powershell or the command line in this folder. Then type: pip Install -r requirements .txt

   • If it fails use the full path to the python installation. Pip is located in PYTHON_INSTALLATION_DIRECTORY\Scripts\pip.exe.
   • e.g.: C:\Users\USERNAME\AppData\Local\Programs\Python\Python36-32\Scripts\pip.exe install -r requirements.txt for python 3.6 pip might ask you to upgrade Currently this is not required.
   • This will install all required libraries for the bot to function

4. Go to https://discordapp.com/developers/applications/me/ and click new App

   • Give the app a name and Icon then Click Create app
   • Scroll to the bottom of the page and click Create a Bot user
   • Click Token:Click to reveal and copy the Token

5. Copy the config.example.py to config.py, this can be done with the command or gui

   • linux: cp config.example.py config.py
   • powershell: Copy-Item .\config.example.py .\config.py

6. Open the config.py file with an editor and paste the token on the line token = 'Token goes here' be sure to keep the ticks '' :).

   • You can adapt various settings in this file, for example channels where the bot automatically parses pastebins or owners.
   • active_channels=['channel1','channel2'] - multiple channels are separated by commas, be sure to keep the ticks here too.
   • owner=[''] works the same way

7. Go back to the powershell and use python discord_pob.py, the bot should start up now

   • If not use the full path again C:\Users\USERNAME\AppData\Local\Programs\Python\Python36-32\python.exe discord_pob.py

8. :Now go to https://discordapp.com/developers/applications/me and invite the bot to your channel

   • Guide from the MusicBot wiki

Running

Every time you want to run the bot you need to execute the same command in 6. above

Stopping

Ctrl+c in the powershell/command line to stop execution

Updating

If the bot worked once updating will be easy

• Manual: Download the newest zip file, copy your config.py from the existing folder to another location, make a copy config.example.py and redo step 6 above with the information from your old config.py. You can also just paste your old config but that might lead to issues if anything changes later on. Then run the bot again.
• Automatic: Install git or github and just pull from the master branch for a stable release :). Run the bot again.