A Discord py bot for Windows which downloads a channel's images. How convenient!
- Python 3.4.2+ with
pip
- The bot will NOT WORK with python 3.7.0. Use pyenv if needed (latest compatible version: 3.6.6).
If you host active art channels and want to keep a steady archive of its creations, manually downloading images is a hassle. The "recommended" solution is to use self-botting tools, which is a violation of Discord's terms of service.
With Grabulous, every image uploaded to your server can be downloaded with a unique tag and ID, so you can focus on removing duplicates, categorizing images, and creating a more streamlined experience for anyone looking for certain creators or images.
Grabulous is a self-hosted bot; it only runs when you want it to, and it runs from your own computer.
- Install Python!
- Clone or download this repo and unzip
Grabulous-master
where you want - Run
pip install -r requirements.txt
to install dependencies- You can ignore the dependencies errors from
discord-py
, it works fine for now.
- You can ignore the dependencies errors from
- Create a Discord Bot, get an application token, and add the bot to your server
- Create a file called
inf.py
and add the following line followed by a line break:
def token(): return "Replace this text with your application token"
- Activate Developer Mode in Discord and copy your User ID (video, 20 seconds)
- In
Grabulous-master
, openconfig.cxr
in a text editor like Notepad++
Grabulous uses an easy-to-read markup language and loads/saves them as .cxr
files. Items in these files look like this:
#key
/ Lines with a slash are ignored!
/ Tags and values are separated by a colon.
tag: value
other tag: other value
tag without value
You will be adding to these files
- Paste your User ID under
#permissions
in place of the long string of 0s. - If there is a different folder or file path where you want images to download (such as a local Google Drive folder) then change the value of root under
#init
like so:
root: /path/to/download/location
- Run the bot with
python grabulous.py
- In Discord, type one of the commands below to begin downloading images:
-grab downloads images from the channel which the command was posted in
-grab #channel downloads images from the tagged channel
-grab #channel1 #channel2 ... downloads images from all tagged channels
If you appreciate what this bot does, consider pledging to the upstream Patreon! Every bit makes a difference.