# tangyoha/telegram_media_downloader architecture

> Architecture diagram of the GitHub repository tangyoha/telegram_media_downloader, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tangyoha/telegram_media_downloader
- Repository: https://github.com/tangyoha/telegram_media_downloader

## Overview

Telegram Media Downloader supports one-shot downloads and a Telegram bot workflow, with a web interface for operation. In the download path, Telegram messages are selected from configured chats, optionally filtered, then media is downloaded and saved; bot commands also support forwarding and monitoring. Configuration covers media types and formats, file organization, and optional cloud-drive uploads. The source index supports the principal runtime dependencies shown below; unsampled implementations and dynamic web wiring limit certainty about some subsystem links.

Main entry points: [`media_downloader.py`](https://github.com/tangyoha/telegram_media_downloader/blob/master/media_downloader.py) (Downloader entry), [`module/bot.py`](https://github.com/tangyoha/telegram_media_downloader/blob/master/module/bot.py) (Bot commands), [`module/web.py`](https://github.com/tangyoha/telegram_media_downloader/blob/master/module/web.py) (Web interface), [`module/app.py`](https://github.com/tangyoha/telegram_media_downloader/blob/master/module/app.py) (App configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Message intake"]
  node_runner["Downloader entry"]
  node_bot["Bot commands<br/>[bot.py]"]
  node_history["Chat history"]
end

subgraph group_processing["Download processing"]
  node_app["App configuration<br/>[app.py]"]
  node_filter["Message filters<br/>[filter.py]"]
  node_metadata["Message metadata<br/>[meta_data.py]"]
  node_transfer["Media transfer"]
  node_group_send["Media groups"]
  node_stats["Download status<br/>[download_stat.py]"]
end

subgraph group_interfaces["User interfaces"]
  node_web["Web interface<br/>[web.py]"]
  node_language["Translations<br/>[language.py]"]
  node_crypto["Web crypto assets"]
end

subgraph group_services["Storage and services"]
  node_local_files["Local file output"]
  node_cloud["Cloud-drive upload<br/>[cloud_drive.py]"]
end

node_user(("User"))
node_telegram(("Telegram"))

node_user -->|"runs once"| node_runner
node_user -->|"issues commands"| node_bot
node_user -->|"uses interface"| node_web
node_runner -->|"loads config"| node_app
node_runner -->|"reads history"| node_history
node_runner -->|"uses transfer"| node_transfer
node_runner -->|"starts bot"| node_bot
node_runner -->|"starts web"| node_web
node_bot -->|"uses settings"| node_app
node_bot -->|"checks messages"| node_history
node_bot -->|"uses filters"| node_filter
node_app -->|"uses filters"| node_filter
node_filter -->|"evaluates fields"| node_metadata
node_transfer -->|"sends groups"| node_group_send
node_transfer -->|"updates progress"| node_stats
node_runner -->|"tracks tasks"| node_stats
node_runner -->|"saves media"| node_local_files
node_app -->|"configures uploads"| node_cloud
node_cloud -.->|"uploads saved files"| node_local_files
node_web -->|"uses application"| node_app
node_web -->|"shows status"| node_stats
node_web -.->|"uses crypto assets"| node_crypto
node_bot -->|"localizes messages"| node_language
node_telegram -.->|"provides messages"| node_history
node_transfer -.->|"downloads media"| node_telegram

click node_runner "https://github.com/tangyoha/telegram_media_downloader/blob/master/media_downloader.py"
click node_bot "https://github.com/tangyoha/telegram_media_downloader/blob/master/module/bot.py"
click node_history "https://github.com/tangyoha/telegram_media_downloader/blob/master/module/get_chat_history_v2.py"
click node_web "https://github.com/tangyoha/telegram_media_downloader/blob/master/module/web.py"
click node_app "https://github.com/tangyoha/telegram_media_downloader/blob/master/module/app.py"
click node_filter "https://github.com/tangyoha/telegram_media_downloader/blob/master/module/filter.py"
click node_metadata "https://github.com/tangyoha/telegram_media_downloader/blob/master/utils/meta_data.py"
click node_transfer "https://github.com/tangyoha/telegram_media_downloader/blob/master/module/pyrogram_extension.py"
click node_group_send "https://github.com/tangyoha/telegram_media_downloader/blob/master/module/send_media_group_v2.py"
click node_stats "https://github.com/tangyoha/telegram_media_downloader/blob/master/module/download_stat.py"
click node_language "https://github.com/tangyoha/telegram_media_downloader/blob/master/module/language.py"
click node_local_files "https://github.com/tangyoha/telegram_media_downloader/blob/master/media_downloader.py"
click node_cloud "https://github.com/tangyoha/telegram_media_downloader/blob/master/module/cloud_drive.py"
click node_crypto "https://github.com/tangyoha/telegram_media_downloader/tree/master/module/static/aes/crypto-js-master"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_runner,node_bot,node_history,node_user toneBlue
class node_app,node_filter,node_metadata,node_transfer,node_group_send,node_stats toneAmber
class node_web,node_language,node_crypto toneMint
class node_local_files,node_cloud toneRose
class node_telegram toneIndigo
```

## Components

### Message intake

- [Downloader entry](https://github.com/tangyoha/telegram_media_downloader/blob/master/media_downloader.py): `media_downloader.py`
- [Bot commands](https://github.com/tangyoha/telegram_media_downloader/blob/master/module/bot.py): `module/bot.py`
- [Chat history](https://github.com/tangyoha/telegram_media_downloader/blob/master/module/get_chat_history_v2.py): `module/get_chat_history_v2.py`

### Download processing

- [App configuration](https://github.com/tangyoha/telegram_media_downloader/blob/master/module/app.py): `module/app.py`
- [Message filters](https://github.com/tangyoha/telegram_media_downloader/blob/master/module/filter.py): `module/filter.py`
- [Message metadata](https://github.com/tangyoha/telegram_media_downloader/blob/master/utils/meta_data.py): `utils/meta_data.py`
- [Media transfer](https://github.com/tangyoha/telegram_media_downloader/blob/master/module/pyrogram_extension.py): `module/pyrogram_extension.py`
- [Media groups](https://github.com/tangyoha/telegram_media_downloader/blob/master/module/send_media_group_v2.py): `module/send_media_group_v2.py`
- [Download status](https://github.com/tangyoha/telegram_media_downloader/blob/master/module/download_stat.py): `module/download_stat.py`

### User interfaces

- [Web interface](https://github.com/tangyoha/telegram_media_downloader/blob/master/module/web.py): `module/web.py`
- [Translations](https://github.com/tangyoha/telegram_media_downloader/blob/master/module/language.py): `module/language.py`
- [Web crypto assets](https://github.com/tangyoha/telegram_media_downloader/tree/master/module/static/aes/crypto-js-master): `module/static/aes/crypto-js-master`

### Storage and services

- [Local file output](https://github.com/tangyoha/telegram_media_downloader/blob/master/media_downloader.py): `media_downloader.py`
- [Cloud-drive upload](https://github.com/tangyoha/telegram_media_downloader/blob/master/module/cloud_drive.py): `module/cloud_drive.py`

### Other components

- **User**
- **Telegram**

## Connections

- User → Downloader entry: runs once
- User → Bot commands: issues commands
- User → Web interface: uses interface
- Downloader entry → App configuration: loads config (evidence: `media_downloader.py`)
- Downloader entry → Chat history: reads history (evidence: `media_downloader.py`)
- Downloader entry → Media transfer: uses transfer (evidence: `media_downloader.py`)
- Downloader entry → Bot commands: starts bot (evidence: `media_downloader.py`)
- Downloader entry → Web interface: starts web (evidence: `media_downloader.py`)
- Bot commands → App configuration: uses settings (evidence: `module/bot.py`)
- Bot commands → Chat history: checks messages (evidence: `module/bot.py`)
- Bot commands → Message filters: uses filters (evidence: `module/bot.py`)
- App configuration → Message filters: uses filters (evidence: `module/app.py`)
- Message filters → Message metadata: evaluates fields (evidence: `module/filter.py`)
- Media transfer → Media groups: sends groups (evidence: `module/pyrogram_extension.py`)
- Media transfer → Download status: updates progress (evidence: `module/pyrogram_extension.py`)
- Downloader entry → Download status: tracks tasks (evidence: `media_downloader.py`)
- Downloader entry → Local file output: saves media (evidence: `media_downloader.py`)
- App configuration → Cloud-drive upload: configures uploads (evidence: `module/app.py`)
- Cloud-drive upload → Local file output: uploads saved files
- Web interface → App configuration: uses application (evidence: `module/web.py`)
- Web interface → Download status: shows status (evidence: `module/web.py`)
- Web interface → Web crypto assets: uses crypto assets
- Bot commands → Translations: localizes messages (evidence: `module/bot.py`)
- Telegram → Chat history: provides messages
- Media transfer → Telegram: downloads media
