Telegram Bot to verify if users joining a group are human.
 
 
 
 
Go to file
J-Rios e5ee8fc650 Added Basque language contributor to readme file. 2019-09-08 12:23:31 +02:00
docker Isolate languages text (no reference to other languages in each lang file). Complete Basque language support. 2019-09-06 22:56:14 +02:00
sources Isolate languages text (no reference to other languages in each lang file). Complete Basque language support. 2019-09-06 22:56:14 +02:00
.gitignore Detect and remove Spam from non text messages too (resend messages, embedded links in text, images, audios, files, etc.). 2019-04-13 12:26:45 +02:00
.gitmodules Use captcha generator library as submodule instead local. 2019-04-13 13:52:12 +02:00
LICENSE Initial commit 2018-09-09 22:05:45 +02:00
README.md Added Basque language contributor to readme file. 2019-09-08 12:23:31 +02:00
requirements.txt Removed unnecesary telegram library from requirements install file. 2019-08-05 21:27:30 +02:00

README.md

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: