tangyoha/telegram_media_downloader

Features

• Telegram Media Downloader - Provides a specialized tool for retrieving media files from Telegram chats and channels.
• Media Content Archivers - Downloads files from chats and moves them to final storage while skipping existing duplicates.
• Telegram Media Management - Downloads and organizes photos, videos, and documents from Telegram chats into a structured local backup.
• Media Organization - Constructs custom directory paths and filenames using chat titles, timestamps, and media types.
• Media Extraction Tools - Extracts photos, videos, audio, and documents from chat histories using pagination and offset tracking.
• Chat Message Archiving - Implements capabilities for capturing and storing Telegram chat histories and metadata as permanent archives.
• Chat Media Extractors - Retrieves media from specific chats using message ID ranges and file-type filters.
• Message Filtering - Applies custom logic expressions to determine which messages are processed during archive operations.
• Regex Content Filtering - Uses custom regular expressions and logic to include or exclude specific messages and media during processing.
• Media Content Filters - Selects specific media for download based on dates, file sizes, sender identity, or custom regular expressions.
• Automated File Organizers - Defines custom folder structures and filenames using configurable prefixes and date formats.
• Media Selection Filters - Selects media for download based on granular criteria such as file size, date, resolution, and sender.
• Web-Based Archive Management - Provides a web-based interface for queuing and managing digital content archiving tasks via a browser.
• Cloud File Uploaders - Transfers files to external cloud providers and cleans up local files only upon successful confirmation.
• Metadata-Driven Directory Mapping - Constructs hierarchical folder structures and filenames by parsing chat titles and timestamps.
• Cloud File Sync - Uploads downloaded media files to remote cloud providers using a configurable external sync tool.
• Media Metadata Extraction - Populates data objects with sender and media attributes to enable complex filtering of content.
• Download Management Web Services - Ships a self-hosted web interface to control the downloader and monitor progress from a remote host.
• Album Group Downloads - Groups related photos, videos, and documents sent as a single album and processes them as a coordinated set.
• Media Content Retrievers - Retrieves audio, photos, and videos from specific chats or channels using API credentials.
• Telegram Clients - Acts as a backend application using the Telegram API to programmatically retrieve chat history and export media.
• Cross-Chat Media Forwarders - Automates the transfer of messages and media between Telegram chats, including handling protected content.
• Bot-Driven Task Management - Creates a bot to trigger media downloads, monitor chats, and manage transfer tasks via commands.
• Session Persistence - Persists encrypted platform session tokens to disk to maintain authenticated access across restarts.
• Task Progress Monitors - Offers a web dashboard to track download status and manage server settings with password protection.
• Multi-Interface Control Planes - Coordinates application state and task management across a web dashboard, bot commands, and a CLI.
• Web Dashboards - Provides a web-based dashboard for real-time download monitoring and file visibility management.
• Automatic Message Forwarding - Monitors source chats and automatically forwards new incoming messages to a destination based on defined filters.
• Web-Based Control Panels - Provides a browser-based dashboard for interacting with the application and managing download tasks.
• Chat Media Monitoring - Polls chats at regular intervals to trigger download or forward pipelines when new messages arrive.
• Parallel Chat Processing - Processes media from several different chat entries independently while tracking progress for each separately.
• Restricted Content Downloaders - Downloads media from restricted chats to local storage for later re-upload when forwarding is disabled.
• Caption Cleaning - Processes message captions through a pipeline that removes promotional text while preserving formatting.
• Protected Content Re-uploading - Copies media from one chat to another by downloading and re-uploading files if content is protected.
• Message Text Export - Saves the text content of messages as accompanying text files during the download process.
• Cloud Storage Adapters - Uses cloud storage adapters to transfer local media archives to various remote storage providers.
• Cloud Storage Integrations - Manages integration settings for automatically pushing downloaded media to configured cloud storage providers.
• Cloud Storage Sync Tools - Uploads archived Telegram media to remote cloud providers with optional compression.
• Cloud Storage Synchronization - Uploads downloaded Telegram media to remote cloud providers while maintaining folder structures and compressing files.
• File Existence Checks - Checks for the existence of a file at the target path before initiating a download.
• Chat Media Transfers - Transfers media files from one Telegram conversation to another within the platform.
• Metadata-Based Organization - Saves downloaded media into folders and filenames based on chat titles, timestamps, or custom patterns.
• Persistent Application State - Saves user settings and runtime progress to local files to facilitate resuming interrupted downloads.
• Local-to-Cloud File Transfers - Uploads organized local archives to cloud providers while preserving directory structures.
• Local Filesystem Storage - Saves files into custom directory structures using metadata like chat titles and message IDs.
• Pattern-Based Extraction - Identifies and normalizes date and time strings from text into a standardized format using pattern search.
• Transfer Progress Monitors - Calculates real-time download speed and byte accumulation for active file transfers.
• Download Progress Tracking - Records the last processed message ID and maintains a list of failed IDs to allow recovery after failure.
• Task Restarts - Restores system state from configuration files to resume failed downloads and continue from the last read message.
• Multi-Interface Management - Offers multiple management interfaces including a web dashboard, bot commands, and a command-line interface.
• Content Restriction Bypasses - Creates compatible media objects from local files to bypass restrictions that prohibit direct forwarding.
• File Extension Resolution - Determines the correct file extension for downloaded media by decoding file identifiers and guessing MIME types.
• Download Organization Tools - Automates the naming, sorting, and directory placement of downloaded media files.
• Download Progress Tracking - Reports real-time download progress including bytes transferred and total size through a web interface.
• Resumable Transfers - Restores interrupted transfers by persisting the last processed message ID and tracking failed downloads.
• Bot-Driven Forwarding - Sends messages to other chats using bot commands as an alternative to local disk storage.
• Metadata-Driven Archiving - Constructs directory and file names using metadata like chat titles and captions to create a structured archive.
• Download Resumption Managers - Persists the last processed message ID and tracks failed downloads to resume interrupted transfers.
• Exponential Backoff Retries - Employs an exponential backoff strategy to handle API rate-limiting errors and connection exceptions.
• API Rate Limit Management - Implements retry logic and back-off timers to handle Telegram API rate limits and FloodWait errors.
• Application Management Dashboards - Provides a browser-based dashboard for interacting with the application and monitoring download progress.
• Atomic File Writes - Prevents file corruption by downloading media to a temporary staging area before moving to final storage.
• Error Recovery - Includes automated retry logic to recover from API rate limits and network timeouts during data transfers.
• Download Throughput Controls - Configures concurrent download workers and rate limits to optimize data transfer speeds.
• Producer-Consumer Workflow Managers - Uses a producer-consumer workflow to decouple message discovery from concurrent media downloads.
• Request Rate Limiting - Enforces a sliding window of maximum calls per minute to avoid service throttling during message forwarding.
• Task Management - Provides an interface to monitor and terminate individual or categorized background download and forwarding tasks.
• Transfer Monitoring Tools - Tracks the state of download tasks through various stages to monitor progress and prevent duplicates.
• Caption Branding - Removes specified advertisement text from captions and appends custom branding before uploading.

Star history