This project provides a powerful Telegram message forwarding tool that allows users to forward messages from multiple sources to specified destinations without requiring bots to join the chats. It's designed for information aggregation, filtering, and content collection, enabling users to bypass restrictions on forwarding and copying. The tool integrates with Apprise for multi-platform notifications, extending its utility to various services like chat apps, email, SMS, and webhooks.

How It Works

The forwarder operates by leveraging a user's Telegram account to monitor specified channels or groups. It processes messages through a configurable pipeline that includes keyword filtering (whitelist/blacklist), regular expression matching and replacement, media filtering, and content modification. Users interact with the bot via commands to bind sources, configure settings, and manage filters. The architecture supports both user and bot forwarding modes, with options for message editing or forwarding, and integrates AI capabilities for advanced processing like translation and summarization.

Quick Start & Requirements

• Installation: Primarily via Docker Compose. Download docker-compose.yml and .env.example, rename to .env, fill in API credentials (API_ID, API_HASH, BOT_TOKEN, USER_ID), then run docker-compose up -d.
• Prerequisites: Telegram API credentials, a Telegram bot token, and your Telegram User ID.
• Resources: Requires Docker and Docker Compose.
• Documentation: Usage Guide, Features, Commands.

Highlighted Details

• Supports multi-source forwarding with keyword and regex filtering.
• Integrates AI for content summarization, translation, and intelligent filtering.
• Enables multi-platform notifications via Apprise.
• Includes RSS feed generation for Telegram channels/groups.
• Offers message editing capabilities for admin-controlled chats.

Maintenance & Community

The project is maintained by Heavrnl. Community interaction and support channels are not explicitly mentioned in the README.

Licensing & Compatibility

• License: GPL-3.0.
• Compatibility: GPL-3.0 is a strong copyleft license. Commercial use or linking with closed-source projects may require careful consideration of license obligations.

Limitations & Caveats

The README notes that forwarding to "Saved Messages" is not recommended due to complexity. The RSS feature requires specific Nginx configuration for external access and lacks a password recovery mechanism. AI features may incur significant API costs.