This is a bot I'm working on for a small discord group I'm in. This is something I'll work on in my spare time. This was originally for a groupme chat, but we transitioned to discord. Nothing but just a fun little side project for when I'm bored.
python-atomicwrites: Powerful Python library for atomic file writes
google-api-python-client (only needed if you will be doing yt searches from the bot)
Before the bot can listen to a group, it needs to be added to that group. Do that first or the bot won't work.
There are two ways to run the bot.
- python3 start.py
- Docker
Make sure to change the information in main.py to what you want such as the location of your groupme key or youtube key.
You have to pick a deliminator to use this bot. The default one is $. You can change it by passing it to the bot
object
The bot looks for Credentials in config.ini that is at the root of the repo. An example file has been provided.
Using the provided Dockerfile, you can build an image with docker build -t groupme-bot .
If you don't mount a volume to the container, any tags that are made will be lost once the container is stopped.
Once the image is built, you can run it with:
docker run -ditv --rm -v [local tag folder]:/home/groupme/app/tags -v [local config.ini]:/home/groupme/app/config.ini --name groupme groupme-bot
add -m [amount] or --cpus=[number] to limit the ram or CPU cores the container can use
To attach to a detached container, follow these steps (assuming you ran it with the -it arguments):
docker ps to find the Container ID
docker attach [Container ID] to attach to it
docker stop [Container ID] to stop the container
Ctrl-C to shutdown the container
Ctrl-p Ctrl-q to detach from it
| command | argument(s) | example |
|---|---|---|
| avatar | [mention_name] | avatar @name |
| git | none | git |
| yt** | [query] | yt skateboard tricks |
** yt command will only post the first link from the youtube search
| command | argument(s) | example |
|---|---|---|
| create | [tag_name] [stuff]** | tag create cooltag this is a cool tag |
| edit | [tag_name] [stuff]** | tag edit cooltag this is a new edit |
| delete | [tag_name] | tag delete cooltag |
| none | [tag_name] | tag cooltag |
| list | none | tag list |
| owner | [tag_name] | tag owner cooltag |
| gift | [tag_name] @mention | tag gift cooltag @new_owner |
| rename | [tag_name] [new tag_name] | tag rename cooltag coolertag |
| help | none | tag help |
** [stuff] can be a string, a link to anything, or an image that is upload through groupme
** If [stuff] is an image uploaded through groupme, then the description with the image should just be:
tag create [tag_name]
The commands create, edit, delete, gift, and rename can only be down by the owner of the tag.
The owner is whoever created the tag.
owner command will get the user_id of the owner and will find attempt to match it to the nickname of the owner.
This is the json structure of tags
{
"id": "group id goes here",
"name": "group name goes here",
"tags": {
"tag1": {
"content": "tag1 content",
"owner": "owner id"
},
"tag2": {
"content": "tag2 content",
"owner": "owner id"
}
}
}