Skip to content
A Telegram bot to guard against low-effort spambots in large groups.
Go
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
database
handlers
helpers
test
.gitignore
.travis.yml
LICENSE
README.md
bigboofer-demo00.png
bigboofer-demo01.png
bigboofer-demo02.png
bigboofer-demo03.png
bigboofer-demo04.png
bigboofer-demo05.png
bigboofer.png
config.go
go.mod
go.sum
run.go

README.md

tg-big-boofer Build Status

A Telegram bot to guard against low-effort spambots in large groups.


To add to your group

Add @BigBooferBot to your group. For enforcement to work (see below), they must be an admin of the group they are a part of.

a friend

Once added to the group, if you are an admin, promote @BigBooferBot to an admin, and configure the passphrase via /setchannel <channel_url> <passphrase>:

a friend

@BigBooferBot will then begin enforcement.

When a new user joins your group...

  • They will be welcomed by a big friend, @BigBooferBot, and will be directed to a separate channel, containing a passphrase (and whatever else you want, e.g. rules). a friend

  • Until they reply in the channel with the passphrase, all of their messages will either not be allowed to be posted, or deleted as soon as they are posted. a friend

  • If they don't reply with the passphrase within 5 minutes, @BigBooferBot will (regretably) remove them from the group. a friend

  • ...but admins can manually approve new users at any time. a friend

To run

BigBoofer uses go modules, so it requires Go >= 1.11.0.

Contact @BotFather on Telegram for an API key. Then, set your API key in config.go and run:

go build

It should pull in all required dependencies and produce a binary ready for you to run.

To test

go test -v bigboofer/test
You can’t perform that action at this time.