/TLG_JoinCaptchaBot

Telegram Bot to verify if users that join a group, are humans. The Bot send an image captcha for each new user, and kick any of them that can't solve the captcha in a specified time.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

TLG_JoinCaptchaBot

Bot to verify if a new user, who join a group, is human. The Bot send an image captcha for each new user, and kick any of them that can't solve the captcha in a specified time. Also, any message that contains an URL sent by a new "user" before captcha completion, will be considered Spam and will be deleted.

Installation:

To generate Captchas, the Bot uses multicolor_captcha_generator library, wich uses Pillow to generate the images.

  1. Install Pillow prerequisites:
apt-get install libtiff5-dev libjpeg8-dev zlib1g-dev libfreetype6-dev liblcms2-dev libwebp-dev tcl8.6-dev tk8.6-dev python-tk
  1. Get the project and install JoinCaptchaBot requirements:
git clone --recurse-submodules https://github.com/J-Rios/TLG_JoinCaptchaBot
pip install -r TLG_JoinCaptchaBot/requirements.txt
  1. Go to project sources and give execution permission to usage scripts:
cd TLG_JoinCaptchaBot/sources
chmod +x run status kill
  1. Specify Telegram Bot account Token (get it from @BotFather) in "constants.py" file:
Change 'TOKEN' : 'XXXXXXXXX:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'

Usage:

To ease usage, a run, status and kill scripts has been provided.

  • Launch the Bot:
./run
  • Check if the script is running:
./status
  • Stop the Bot:
./kill

Docker

You can also run the bot on Docker. This allows easy server migration and automates the download of all dependencies. Look at the docker specific documentation for more details.

Languages Contributors: