GitPlanet

Cheap and reliable Node.js hosting starts at $3/month, and $1/month static HTML hosting

Created with love in Canada, visit hostnodejs.com today

Feel like to post an Ad? Learn Details
All Projects → thedevs-network → The Guard Bot

thedevs-network / The Guard Bot

Licence: agpl-3.0
The Guard, a Telegram bot to moderate groups.

Programming Languages

javascript
184084 projects - #8 most used programming language

Labels

bottelegramtelegram-bot

Projects that are alternatives of or similar to The Guard Bot

Vk To Telegram Transfer Bot
Бот, пересылающий сообщения из чатов ВК в Telegram и обратно
Stars: ✭ 143 (-52.17%)
Mutual labels:  bot, telegram-bot, telegram
Telebot
Write Telegram bots in Rust with Tokio and Futures
Stars: ✭ 179 (-40.13%)
Mutual labels:  bot, telegram-bot, telegram
Telegram Bot Sdk
🤖 Telegram Bot API PHP SDK. Lets you build Telegram Bots easily! Supports Laravel out of the box.
Stars: ✭ 2,212 (+639.8%)
Mutual labels:  bot, telegram-bot, telegram
Node Telegram Api
A simple API to create and control Telegram bots
Stars: ✭ 117 (-60.87%)
Mutual labels:  bot, telegram-bot, telegram
Example Bot
[WIP] An A-Z example of a PHP Telegram Bot.
Stars: ✭ 211 (-29.43%)
Mutual labels:  bot, telegram-bot, telegram
Telegram.bot
.NET Client for Telegram Bot API
Stars: ✭ 1,964 (+556.86%)
Mutual labels:  bot, telegram-bot, telegram
Micro Bot
🤖 Zero-configuration Telegram bot runner
Stars: ✭ 173 (-42.14%)
Mutual labels:  bot, telegram-bot, telegram
Hackernewsbot
📰 Telegram bot that posts new hot stories from Hacker News to telegram channel
Stars: ✭ 103 (-65.55%)
Mutual labels:  bot, telegram-bot, telegram
Telegram Bot Api
First Telegram Bot API node.js library
Stars: ✭ 205 (-31.44%)
Mutual labels:  bot, telegram-bot, telegram
Telegram Rat
Windows Remote Administration Tool via Telegram. Written in Python
Stars: ✭ 201 (-32.78%)
Mutual labels:  bot, telegram-bot, telegram
Telegram Clonebot
Simple Bot to clone Google Drive Files (or Folders) to your Team Drive[or Normal Drive]. P.S This is not a Mirror Bot. Enjoy ✌🏻
Stars: ✭ 114 (-61.87%)
Mutual labels:  bot, telegram-bot, telegram
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.
Stars: ✭ 226 (-24.41%)
Mutual labels:  bot, telegram-bot, telegram
Novagram
An Object-Oriented PHP library for Telegram Bots
Stars: ✭ 112 (-62.54%)
Mutual labels:  bot, telegram-bot, telegram
Expressbot
一个可以帮你订阅、查询快递物流、跟你闲聊Telegram机器人
Stars: ✭ 137 (-54.18%)
Mutual labels:  bot, telegram-bot, telegram
Zanzara
Asynchronous PHP Telegram Bot Framework built on top of ReactPHP
Stars: ✭ 107 (-64.21%)
Mutual labels:  bot, telegram-bot, telegram
Java Telegram Bot Tutorial
Java Telegram Bot Tutorial. Feel free to submit issue if you found a mistake.
Stars: ✭ 165 (-44.82%)
Mutual labels:  bot, telegram-bot, telegram
Telegram Bot
Telegram Bot using AWS API Gateway and AWS Lambda
Stars: ✭ 96 (-67.89%)
Mutual labels:  bot, telegram-bot, telegram
Telegram Bot Github
Allows to you receive GitHub notifications right in the Telegram
Stars: ✭ 103 (-65.55%)
Mutual labels:  bot, telegram-bot, telegram
Icopy
fclone telegram interface.Send commands to Telegram BOT for get a convience way to control fclone resources copy missions.
Stars: ✭ 188 (-37.12%)
Mutual labels:  bot, telegram-bot, telegram
Urban Bot
🤖 The universal chatbot library based on React. Write once, launch Telegram, Facebook, Slack, ... every messenger with chatbots
Stars: ✭ 223 (-25.42%)
Mutual labels:  bot, telegram-bot, telegram
View All Similar Projects ➔

The Guard Bot

The Guard is a Telegram bot made to help admins manage their groups.

Initially created to moderate The Devs Network.

NOTE: The Guard is in beta phase; it has known issues, but it's successfully being used in production

If you need help with using the Bot or setting it up, join our Support Chat.

Setup

You need Node.js (>= 12) to run this bot.

  1. Create a bot via @BotFather and grab a token.
  2. Clone this repository or download zip.
  3. Install dependencies via npm install.
  4. Copy example.config.js to config.js and edit it.
  5. Start the bot via npm start.

Setup with Docker

You need to have docker installed on your machine.

  1. Create a bot via @BotFather and grab a token.
  2. Clone this repository or download zip.
  3. Copy example.config.js to config.js and edit it.
  4. Run docker build -t the_guard_bot . to build image.
  5. Run docker run -v $(pwd)/data:/app/data --rm -itd the_guard_bot to start the bot.

Now you can add the bot as administrator to your groups.

Features

  • Synchronized database across multiple groups.
  • Adding admins to the bot.
  • Auto-remove and warn channels and groups ads.
  • Kick bots added by users.
  • Warn and ban users to control the group.
  • Commands work with replying, mentioning and ID.
  • Removes commands and temporary bot messages.
  • Ability to create custom commands.
  • Supports plugins.

Overall, keeps the groups clean and healthy to use.

Commands

Command Role Available at Description
/admin Master Everywhere Makes the user admin in the bot and groups.
/unadmin Master Everywhere Demotes the user from admin list.
/leave <name|id> Master Everywhere Make the bot to leave the group cleanly.
/hidegroup Master Groups Revoke invite link and hide the group from /groups list.
/showgroup Master Groups Make the group accessible via /groups list.
/del [reason] Admin Everywhere Deletes replied-to message.
/warn <reason> Admin Groups Warns the user.
/unwarn Admin Everywhere Removes the last warn from the user.
/nowarns Admin Everywhere Clears warns for the user.
/permit Admin Everywhere Permits the user to advertise once, within 24 hours.
/ban <reason> Admin Groups Bans the user from groups.
/unban Admin Everywhere Removes the user from ban list.
/user Admin Everywhere Shows the status of the user.
/addcommand <name> Admin In-Bot Create a custom command.
/removecommand <name> Admin In-Bot Remove a custom command.
/staff Everyone Everywhere Shows a list of admins.
/link Everyone Everywhere Shows the current group's link.
/groups Everyone Everywhere Shows a list of groups which the bot is admin in.
/report Everyone Everywhere Reports the replied-to message to admins.
/commands Everyone In-Bot Shows a list of available commands.
/help | /start Everyone In-Bot How to use the bot.

All commands and actions are synchronized across all of the groups managed by the owner and they work with replying, mentioning or ID of a user.

If used by reply, /ban and /warn would remove the replied-to message.

The bot is still in beta phase so feel free to open issues and ask for features.

Roadmap

Important Note: Under the AGPL-3.0 license, if you're running your own instance, you should add a link to the source (this repository) in your bot's bio. If you're modifying this source and making your own bot, you should link to the source of your own version of the bot according to the AGPL-3.0 license. Check LICENSE for more info.

The Guard icon is from Entypo+ by Daniel Bruce.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].