a Telegram bot that filters out unwanted words and phrases in group chats. It helps to maintain a clean and respectful environment for communication.

alimiracle 51662ef4ab app 10 months ago
README.md 51662ef4ab app 10 months ago
go.mod 51662ef4ab app 10 months ago
go.sum 51662ef4ab app 10 months ago
main.go 51662ef4ab app 10 months ago

README.md

telegram-censor-bot

telegram-censor-bot is a Telegram bot that filters out unwanted words and phrases in group chats. It helps to maintain a clean and respectful environment for communication.

Features

  • Automatically detects and blocks messages containing banned words.
  • Kicks users who post inappropriate content.
  • Deletes offending messages to keep the chat clean.

Usage

  1. Add telegram-censor-bot in your Telegram group.
  2. Configure the bot to have necessary permissions to delete messages and kick users.
  3. Provide a list of banned words and phrases in a text file.
  4. Start the telegram-censor-bot application.
  5. telegram-censor-bot will monitor the group chat and take actions based on the content of the messages.

Installation

  1. Clone the telegram-censor-bot repository:
git clone https://notabug.org/alimiracle/telegram-censor-bot
  1. Install the required dependencies:
go get
  1. Set the environment variables:
  • TELEGRAM_BOT_TOKEN: Your Telegram bot token.
  • BANNED_WORDS_FILE: The path to the text file containing the list of banned words.
  1. Build and run the telegram-censor-botapplication: bash go build ./telegram-censor-bot

Configuration

Before running the bot, make sure to configure it properly:

  1. Create a new Telegram bot and obtain the bot token from BotFather.
  2. Set the necessary permissions for the bot in your group chat (delete messages, ban users).
  3. Prepare a text file containing the list of banned words and phrases, with each entry on a new line.

License

This project is licensed under the GPL v3 License.