iyear/tdl
Tdl
tdl is a command-line tool for Telegram account automation, media management, and data archiving. It provides a programmatic interface for downloading and uploading files, forwarding messages, and exporting chat history, member lists, and media into structured JSON files.
The project distinguishes itself through a session management system that isolates multiple account identities using unique namespaces. It features expression-based routing for messages and uploads, allowing users to direct content to specific destination chats using custom logic and dynamic caption generation.
The tool covers a broad range of capabilities, including media retrieval from channels and groups, high-bandwidth file transfers, and content migration between chats. It also includes system utilities for proxy server routing, task throttling to manage API rate limits, and a plugin system for third-party extensions.
The software can be deployed in containerized environments and supports configuration via environment variables.
Features
- Telegram API Integrations - Provides a programmatic command-line interface for interacting with Telegram account sessions.
- Account Automation Frameworks - Provides a programmable interface to automate Telegram account interactions, message forwarding, and file routing.
- Local Chat Archiving - Provides capabilities for exporting chat history and media to local JSON files for archival.
- Telegram Media Downloader - Provides a command-line utility to download media and files from Telegram using account sessions.
- Chat Content Extractors - Fetches media and files from protected or public chats and saves them to local storage.
- Content Migration Tools - Implements tools for migrating messages and media between different Telegram chats.
- Identity - Assigns different accounts to specific namespaces to isolate identity data and authentication sessions.
- Structured Data Extraction - Extracts chat history, member lists, and subscriber information into structured JSON files.
- Logic-Based Upload Routing - Directs files to different destination chats based on custom logic and file metadata.
- Telegram Uploaders - Ships a tool for sending local files and directories to Telegram with metadata-based routing.
- Telegram Uploads - Enables the upload of files and directories to specific Telegram chats, saved messages, or forum topics.
- Telegram Media Management - Enables comprehensive downloading and uploading of files, photos, and videos to and from Telegram.
- Channel Content Retrieval - Retrieves files and media from official Telegram channels for local storage.
- Chat Exporters - Extracts media and full message history from Telegram chats into portable JSON formats using size and view filters.
- MTProto Implementations - Implements the MTProto binary protocol to maximize media download and upload speeds.
- Expression-Based Matchers - Uses a logic engine to evaluate expressions for directing files and messages to specific chats.
- Account Session Managers - Manages multiple authenticated Telegram account identities and isolates them via namespaces.
- Persistent Session Managers - Maintains persistent authentication tokens and session state for programmatic account access.
- Session Isolations - Isolates authentication state and session data to allow multiple Telegram accounts to operate simultaneously.
- File Naming and Destination Templates - Applies customizable naming patterns to saved files based on metadata for better organization.
- Extension-Based Download Filters - Restricts downloads to a specific list of allowed file extensions or excludes forbidden ones.
- Member Detail Retrieval - Extracts detailed lists of subscribers, administrators, and bots from chats using administrative permissions.
- Restricted Content Downloaders - Enables the retrieval of files from private or restricted chats using direct message links and authenticated sessions.
- Data Backup Solutions - Exports messages and files to a backup archive to preserve information and prevent data loss.
- Storage Driver Abstractions - Implements interchangeable storage backends to manage how configuration and session data are persisted to disk.
- Tool Integration Plug-ins - Provides a modular system for extending core tool capabilities via third-party plug-ins.
- Album Group Downloads - Automatically detects and downloads all files associated with a media album as a single group.
- Chat Discovery - Retrieves lists of channels and groups based on filters such as names or topics.
- High-Volume API Transfer Optimization - Uses specialized account sessions to download high volumes of media while minimizing rate-limit delays.
- Message Content Modification - Alters the text or captions of messages using dynamic expressions before forwarding.
- Message Routing - Directs messages to specific destination chats based on custom expressions and content filters.
- Transfer Optimization - Implements a high-bandwidth optimization system for faster file retrieval from account sessions.
- Metadata Template Resolvers - Transforms resource metadata using templates to generate standardized and organized file names.
- API Rate Limit Management - Manages outgoing API request frequency using programmable delays to avoid account bans.
- Third-Party Plugins - Integrates external add-on modules to extend the tool's functionality without altering core code.
- Expression-Based Captions - Assigns captions to uploaded files using dynamic expressions that incorporate file metadata and custom styling.
- Download History Archives - Prevents redundant downloads by tracking processed media identifiers and comparing file sizes.
- Message Forwarding Utilities - Relays and routes messages between Telegram chats with support for dynamic captioning.
