This project is a Telegram API client and media archiving system designed to programmatically retrieve chat histories and export media. It functions as a download manager and message forwarder, allowing users to back up photos, videos, and documents from Telegram chats into structured local archives.
The system distinguishes itself through advanced content filtering and forwarding capabilities. It can monitor chats for new messages, apply custom regular expressions to filter media by size or date, and automatically forward content between chats. This includes the ability to export protected content by downloading it locally and re-uploading it to a destination where direct forwarding is restricted.
The application provides a comprehensive set of tools for storage and synchronization, featuring metadata-driven directory mapping and atomic file writes to prevent data corruption. It includes adapters for synchronizing local archives to remote cloud storage providers with optional file compression. Users can manage these operations through a multi-interface control plane consisting of a web-based dashboard, bot commands, and a command-line interface.
The software is distributed as a standalone executable for Windows, macOS, and Linux, and is also available as a containerized deployment.
