Repository files navigation

Telegram Vixen Bot is a bot for automatically banning spammers in Telegram chats.Written in Dart that helps prevent spam in Telegram groupsby generating and sending CAPTCHA challenges to new users with a virtual keyboard.It automatically deletes initial messages from unverified users and supports multiple blocking modes.

• CAPTCHA Verification: Requires new users to complete a CAPTCHA before they can send messages.
• Blocking Modes: Supports different verification and restriction mechanisms.
• Admin API: Provides an API for managing bot settings and operations.
• SQLite Storage: Stores persistent data in an SQLite database.
• Group-Specific Monitoring: Watches only designated groups.
• Metrics Support: Tracks bot performance and user activity.
• Flexible Configuration: Configurable via command-line arguments,.env file, or environment variables.
• Cross-Platform: Runs on Windows, macOS, and Linux, Docker. AMD64 and ARM64 architectures are supported.
• Combot Anti-Spam: Checks messages with Combot Anti-Spam API.
• Reports: Sends reports about activity in the chat.
• Summary: Sends a summary of the chat activity for the last 24 hours.
• Clown Reactions: Reacts to messages with a clown emoji.
• Open-Source: Available under the MIT License.

• [RU] Dart & Flutter
• Dart и Flutter
• Flutter Architecture

The bot supports configuration via command-line arguments, environment variables, or a.env file.

To run the Telegram Vixen Bot, ensure your system meets the following minimum requirements:

• Operating System: Windows, macOS, or a recent Linux distribution
• Processor: x86_64 or ARM64
• Memory: 128 MB RAM
• Storage: 100 MB available space
• Docker: (Optional) For running the bot in a containerized environment

Ensure you haveDart SDK installed. Then, run:

dart pub getdart run build_runner build --delete-conflicting-outputs

You can start the bot using command-line arguments:

dart run bin/vixen.dart --token=123:ABC-DEF --chats=123,-456,-789 --secret=1234567890

Or set the configuration using environment variables:

export CONFIG_TOKEN="123:ABC-DEF"export CONFIG_CHATS="123,-456,-789"export CONFIG_SECRET="1234567890"dart run bin/vixen.dart

Alternatively, create a.env file:

echo"token=123:ABC-DEF"> .envecho"chats=123,-456,-789">> .envecho"secret=1234567890">> .env

Then, start the bot:

dart run bin/vixen.dart

To see all available options, run:

dart run bin/vixen.dart --help

dart pub getdart run build_runner build --delete-conflicting-outputsdart compile exe bin/vixen.dart -o vixen.run

docker build -t vixen:latest.docker compose up

• Mike Matiunin aka Plague Fox

If you want to support the development of our library, there are several ways you can do it:

• Buy me a coffee
• Support on Patreon
• Subscribe through Boosty

We appreciate any form of support, whether it's a financial donation or just a star on GitHub. It helps us to continue developing and improving our library. Thank you for your support!

This project is licensed underThe MIT License.