This discord bot tags messages that contain links with keywords on the web page to increase searchability of old topics.
Visit the Discord Developers page, select your server, and create a new application.
On the application's settings, go to the bot page and add a new bot. If your name is too similar to other bots such as "test bot", you will be rejected and have to change the name.
Once the bot is created, set "Send Messages" and "Manage Messages" in the permissions. The permissions integer is 10240.
You can find your token by the bot icon. Click the reveal button or copy it with the button. The Tag Bot can now be linked to your server. See the sections below to start the bot.
The bot can be run manually or from a Docker container.
Pull the image from dockerhub.
docker pull orionhumphrey/tagbot-slim
Use the -e tag with your discord token to set the BOT_API_TOKEN environment variable.
To start the bot for the first time, run:
docker run --name Tagbot -d -e BOT_API_TOKEN=YourTokenHere orionhumphrey/tagbot-slim
When running the bot a second time, just run:
docker start Tagbot
You should now see the bot in your server. See Usage section below to get started with Tag Bot.
- Python 3
- Pip (Comes with Python)
- Discord API token
Navigate to program directory in a terminal and run the below command to install the required Python packages.
pip install -r requirements.txt
The bot can automatically pull the API token from the computers environment variables or from a .env file.
Set variable name to BOT_API_TOKEN, and set variable value to YourTokenHere.
Here are resources for manually setting environment variables:
The program can also pull a variable from a .env file in the program directory.
In the program directory, create a file with no name and the extension as .env. Inside, write: BOT_API_TOKEN=YourTokenHere
To start the bot, navigate to the program directory in a terminal and run:
python bot.pyYou should now see the bot in your server. Closing the terminal will shutdown the bot. See Usage section below to get started with Tag Bot.
Reply to a message that contains a link with !tag to generated tags for that web page. See the below example.
The command must be used in a reply.
The message replied to must contain a link.
Log handling can be edited in the code. There are two log handlers. One for logging to a file and one for logging to stdout. You will not see stdout logs if using the Docker image in detached mode unless you use the Docker Desktop application. Logs will be stored in bot.log in the program directory and can be accessed via a volume or bind mount if using Docker.
To keep persistent logs while using Docker, add a volume mount or bind mount with the -v option. See example below.
docker run --name Tagbot -d -v tagbot_logs:/usr/src/app/logs -e BOT_API_TOKEN=YourTokenHere orionhumphrey/tagbot-slim
Using a bind mount will allow you to store the logs on the host system folder rather than a docker volume. The syntax changes to -v YourHostDirectory:/usr/src/app/logs. The folder structure will change based on the host OS. Note that the folder on the host system must be created in advance.