A Discord chat bot that creates a thread whenever an image is shared (in specified channels). The goal of SelfieThreadBot is to allow selfie (and other image sharing) channels to focus on the pictures, and have conversation beneath each picture - some what akin to many social media websites. SelfieThreadBot hopes to help create a dedicated space for people to comment on photos instead of feeling awkward about taking up space in the main selfies channel.
Pre-requisites: You must have Docker and Docker Compose already setup. It is reccomended to run chat bots on a dedicated (on 24/7) computer. You can get a free server from Oracle Cloud.
- Download or git clone this repository.
- Setup a discord chat bot in the Discord Developer Portal
- Create a new application and give it a name.
- Click on the Bot section and select Add Bot.
- Copy your token, and add it to the downloaded
auth-example.jsonfile, between the two quotes, and rename the file toauth.json. - Click on OAuth2 then URL Generator.
- Select
botandapplications.commandsunder Scope. No bot permissions are needed. NOTE: SelfieThreadBot will allow access to admin commands for the highest role on your server. You may want check your roles before the next step to make sure the top role is an admininistrative only role. - Copy the link at the bottom of the page, paste it into a new window and add it to a Discord server you are an admin on.
- The bot should appear in your server as offline.
- In a command prompt/terminal window navigate to the directory where you saved the bot.
- Run
docker-compose upto check if the bot is functioning properly. - If the bot comes online and there are no errors, press
CTRL + Con your keyboard twice to stop the bot. - Once the bot has stopped, run
docker-compose up -dto run the bot in detached mode (in the background).
When SelfieThreadBot is added to a server, it assigns permission to run admin commands to the highest listed server role. An admin will need to assign which channel(s) the bot will create threads in. When a member posts a message to that thread with an attachment (picture, video, etc), SelfieThreadBot creates a thread under that message. Members can comment in the thread.
/addselfiechannel #channelwill add a channel for SelfieThreadBot to create threads in./removeselfiechannel #channelwill remove a channel from SelfieThreadBot's watch list./setselfiethreadarchive <time>will set the auto-archive time for all threads that SelfieThreadBot creates. Per Discord's policies, unboosted servers can set this value to 1 day or 1 hour, level 1 boost servers can set this to 3 days, and level 2+ servers can set this to 1 week.
/listselfiechannelswill list all channels that SelfieThreadBot will automatically create threads in when media is shared.
- If you'd like to add SelfieThreadBot to a channel that has custom permissions (that the
@everyonerole can't see/participate in) you need to give the SelfieThreadBot role specific access to view that channel. - SelfieThreadBot can opperate on one or more Discord servers/guilds at once.
- If SelfieThreadBot is kicked from a server any watched channels will be removed as well as thread archive settings.
For any issues or bug reports, please log them in the Issue Tracker on GitHub
Copyright 2021 Ahren Bader-Jarvis
Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
If this project helps you out at all, please consider supporting me on Ko-Fi.
