README.md

PooperScooper

Personal Discord bot using the discord.py library by Rapptz (https://github.com/Rapptz/discord.py)

This bot was intended to be a single server bot and was not developed to be in multiple servers. Feel free to use this as a reference for your own bot.

Note: Some stuff will be hardcoded to particular servers such as menacesroles and grammarpolice cogs. I was too lazy to write something dynamic.

Key Features

1. Music
2. Gametime
3. ImageDiffusion
4. GrammarPolice
5. Role Selection by Emoji
6. Birthday Tracking (Opt in)
7. Poll

Installing

1. Install Python 3.8 or higher

This is a requirement for Discord.py

2. Set up venv

python3.8 -m venv venv

3. Install dependencies

pip install -U -r requirements.txt

4. Create Spotify and Discord integrations

Create your integrations for Spotify and Discord:

• https://developer.spotify.com/dashboard/

• https://discord.com/developers/applications

5. Configure Credentials

Add credentials to config.json from Spotify/Discord. Place in root dir of bot.

{
  "token": "",
  "client_id": "",
  "spotify_client_id": "",
  "spotify_secret": ""
}

6. Configure FFMPEG

Download FFMPEG and add the executable to your environment variables

• https://www.ffmpeg.org/download.html

7. Install Stable/Waifu Diffusion

NOTE: This requires a powerful host platform with at least 4GB+ of VRAM recommended

Follow the instructions to set up Stable/Waifu Diffusion if your system is powerful enough

• https://huggingface.co/hakurei/waifu-diffusion

You might need Pytorch installation from: https://pytorch.org/get-started/locally/

Running

Run the following with administrator privileges

python PooperScooper.py

Add -d switch to set logging level to debug

Links

• Discord.py
• Discord.py Documentation
• Python