Group Butler
Short introduction
This bot has been created to help people administrate their groups, and includes many useful tools.
Group Butler was born as an otouto v3.1 (@mokubot
), but it has been turned into an administration bot.
Group Butler on Telegram:
-
- branch:
master
- channel:
@GroupButler_ch
.
- branch:
-
- branch:
beta
- channel:
@GroupButler_beta
.
- branch:
Setup
List of required packages:
libreadline-dev
redis-server
lua5.2
liblua5.2dev
libssl-dev
git
make
unzip
curl
libcurl4-gnutls-dev
You will need some other Lua modules too, which can be (and should be) installed through the Lua package manager LuaRocks.
Installation
You can easily install Group Butler by running the following commands:
# Tested on Ubuntu 16.04
$ wget https://raw.githubusercontent.com/RememberTheAir/GroupButler/master/install.sh
$ bash install.sh
or
# Tested on Ubuntu 14.04, 15.04 and 16.04, Debian 7, Linux Mint 17.2
$ sudo apt-get update
$ sudo apt-get upgrade
$ sudo apt-get install libreadline-dev libssl-dev lua5.2 liblua5.2-dev git make unzip redis-server curl libcurl4-gnutls-dev
# We are going now to install LuaRocks and the required Lua modules
$ wget http://luarocks.org/releases/luarocks-2.2.2.tar.gz
$ tar zxpf luarocks-2.2.2.tar.gz
$ cd luarocks-2.2.2
$ ./configure; sudo make bootstrap
$ sudo luarocks install luasec
$ sudo luarocks install luasocket
$ sudo luarocks install redis-lua
$ sudo luarocks install lua-term
$ sudo luarocks install serpent
$ sudo luarocks install dkjson
$ sudo luarocks install Lua-cURL
$ cd ..
# Clone the repository and give the launch script permissions to be executed
# If you want to clone the beta branch, use git clone with the [-b beta] option
$ git clone https://github.com/RememberTheAir/GroupButler.git
$ cd GroupButler
$ sudo chmod 777 launch.sh
Other things to check before running the bot:
First of all, take a look at your bot settings:
• Make sure privacy is disabled (more info can be found by heading to the official Bots FAQ page). Send
/setprivacy
to @BotFather to check the current status of this setting.
Before you do anything else, open config.lua (in a text editor) and make the following changes:
• Set
bot_api_key
to the authentication token that you received from@BotFather
.• Insert your numerical Telegram ID into the
superadmins
table. Other superadmins can be added too. It is important that you insert the numerical ID and NOT a string.• Set your
log.chat
(the ID of the chat where the bot will send all the bad requests received from Telegram) and yourlog.admin
(the ID of the user that will receive execution errors).
Before you start the bot, you have to start the Redis process.
# Start Redis
$ sudo service redis-server start
Starting the process
To start the bot, run ./launch.sh
. To stop the bot, press Control CTRL+C twice.
You may also start the bot with lua bot.lua
, however it will not restart automatically.
Something that you should known before run the bot
- You can change some settings of the bot. All the settings are placed in
config.lua
, in thebot_settings
tablecache_time.adminlist
: the permanence in seconds of the adminlist in the cache. The bot caches the adminlist to avoid to hit Telegram limitsnotify_bug
: iftrue
, the bot will send a message that notifies that a bug has occured to the current user, when a plugin is executed and an error happenslog_api_errors
: iftrue
, the bot will send in thelog_chat
(config.lua
) all the relevant errors returned by an api request toward Telegramstream_commands
: iftrue
, when an update triggers a plugin, the match will be printed on the console
- There are some other useful fields that can be filled in
config.lua
db
: the selected Redis database (if you are running Redis with the default config, the available databases are 16). The database will be selected on each start/reload. Default: 2
- Other things that may be useful
- Administrators commands start for
$
. They are not documented, look at the triggers ofplugins/admin.lua
plugin for the whole list - If the main function of a plugin returns
true
, the bot will continue to try to match the message text with the missing triggers of theplugins
table - You can send yourself a backup of the zipped bot folder with the
$backup
command - The Telegram Bot API has some undocumented "weird behaviors" that you may notice while using this bot
- In supergroups, the
kickChatMember
method returns always a positive response if theuser_id
has been part of the group at least once, it doesn't matter if the user is not in the group when you use this method - In supergroups, the
unbanChatMember
method returns always a positive response if theuser_id
has been part of the group at least once, it doesn't matter if the user is not in the group or is not in the group blacklist
- In supergroups, the
- Administrators commands start for
Some notes about the database
Everything is stored on Redis, and the fastest way to edit your database is via the Redis CLI.
You can find a backup of your Redis database in /etc/redis/dump.rdb
. The name of this file and the frequency of saves are dependent on your redis configuration file.
Translators
If you want to help translate the bot, follow the instructions below. Parts of Group Butler use tools from gettext. However we don't use binary format *.mo
for the sake of simplicity. The bot manually parses the *.po
files in the locales
directory.
If you want to improve an existing translation, run this command in the root
directoy with the bot: ./launch.sh update-locale <name>
where <name>
is two letters of your chosen locale. Further edit the file
locales/<name>.po
, make sure that the translation is done correctly and send
us your translation.
We recommend Poedit as editor of *.po
files. You must
specify information about yourself in the settings; put your link to Telegram
account in the field Email if you have it.
If you want to create new locale, run ./launch.sh create-locale <name>
. This
command create the file locales/<name>.po
with untranslated strings. You can
also use Poedit to translate the bot. List of avaible locales see in gettext
manual.
After add your new locale in the file config.lua
.
Pull requests
If you are going to open a pull request, please use the beta
branch as destination branch.
Pull requests in the master
branch won't be considered, unless they are intended to solve a critical problem.
Credits
Topkecleon, for the original otouto
Iman Daneshi and Tiago Danin, for Jack-telegram-bot
Cosmonawt, for his Lua library for the Bot API
Yago Pérez for his telegram-bot
The Werewolf guys, for aiding the spread of the bot
Lucas Montuano, for helping me a lot in the debugging of the bot
All the Admins of our discussion groups about Group Butler
All the people who reported bugs and suggested new stuffs
Le Laide