# jangilimahesh/encoding-bot architecture

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

- Interactive diagram: https://gitdiagram.com/jangilimahesh/encoding-bot
- Repository: https://github.com/jangilimahesh/encoding-bot

## Overview

VideoEncoder is a Telegram bot for downloading video files, configuring and performing FFmpeg-based video/audio processing, and returning results through Telegram or Google Drive. Its main workflow is a Telegram command routed into task handling, followed by download, optional audio rearrangement, encoding, and upload. The README documents broader encoding options, subtitles, watermarks, batch processing, and bot utilities. Some subsystem details are unsampled, so edges are limited to relationships shown in excerpts, the source index, or README statements.

Main entry points: [`VideoEncoder/utils/tasks.py`](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/tasks.py) (Task routing), [`VideoEncoder/utils/encoding.py`](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/encoding.py) (Encoding and media options), [`VideoEncoder/video_utils/audio_selector.py`](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/video_utils/audio_selector.py) (Audio rearrangement), [`VideoEncoder/plugins/callbacks_.py`](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/plugins/callbacks_.py) (Interactive callbacks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Telegram interaction"]
  node_bot_client["Pyrogram bot<br/>[__init__.py]"]
  node_commands["Bot commands<br/>[start.py]"]
  node_settings_ui["Settings menu<br/>[settings.py]"]
  node_callbacks["Interactive callbacks<br/>[callbacks_.py]"]
  node_status["Status and statistics<br/>[status.py]"]
  node_speedtest["Speed test<br/>[speed_test.py]"]
end

subgraph group_workflow["Media workflow"]
  node_task_router["Task routing<br/>[tasks.py]"]
  node_url_download["Direct URL download<br/>[helper.py]"]
  node_drive_download["Drive download<br/>[download.py]"]
  node_task_queue["Task queue<br/>[queue.py]"]
end

subgraph group_processing["Media processing"]
  node_audio_rearrange["Audio rearrangement<br/>[audio_selector.py]"]
  node_encoding["Encoding and media options<br/>[encoding.py]"]
  node_video_tools["Stream and video tools"]
  node_ffmpeg["FFmpeg tools"]
end

subgraph group_state["Settings and state"]
  node_user_settings["Encoding settings<br/>[settings.py]"]
  node_user_database["User database access<br/>[access_db.py]"]
  node_database[("MongoDB storage<br/>[database.py]")]
end

subgraph group_delivery["Delivery and integrations"]
  node_telegram_upload["Telegram upload<br/>[telegram.py]"]
  node_drive_upload["Drive upload<br/>[upload.py]"]
  node_google_drive["Google Drive"]
  node_telegram_service["Telegram"]
end

node_telegram_user(("Telegram user"))

node_telegram_user -->|"sends commands"| node_bot_client
node_bot_client -->|"loads plugins"| node_commands
node_commands -->|"routes media tasks"| node_task_router
node_task_router -->|"downloads direct URLs"| node_url_download
node_task_router -->|"downloads Drive files"| node_drive_download
node_task_router -->|"opens audio menu"| node_audio_rearrange
node_task_router -->|"starts encoding"| node_encoding
node_task_router -.->|"supports media tasks"| node_video_tools
node_encoding -->|"processes media"| node_ffmpeg
node_audio_rearrange -->|"provides stream order"| node_encoding
node_settings_ui -->|"uses settings"| node_user_settings
node_callbacks -->|"handles settings actions"| node_user_settings
node_callbacks -->|"handles audio actions"| node_audio_rearrange
node_task_queue -.->|"coordinates requests"| node_task_router
node_user_database -->|"creates database access"| node_database
node_status -->|"counts users"| node_user_database
node_speedtest -.->|"reports results"| node_telegram_service
node_encoding -->|"passes encoded file"| node_telegram_upload
node_encoding -.->|"offers Drive delivery"| node_drive_upload
node_telegram_upload -->|"uploads results"| node_telegram_service
node_drive_upload -->|"uploads files"| node_google_drive

click node_bot_client "https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/__init__.py"
click node_commands "https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/plugins/start.py"
click node_task_router "https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/tasks.py"
click node_url_download "https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/helper.py"
click node_drive_download "https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/uploads/drive/download.py"
click node_audio_rearrange "https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/video_utils/audio_selector.py"
click node_encoding "https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/encoding.py"
click node_video_tools "https://github.com/jangilimahesh/encoding-bot/tree/audioswap/VideoEncoder/video_utils"
click node_settings_ui "https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/plugins/settings.py"
click node_user_settings "https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/settings.py"
click node_callbacks "https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/plugins/callbacks_.py"
click node_task_queue "https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/plugins/queue.py"
click node_user_database "https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/database/access_db.py"
click node_database "https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/database/database.py"
click node_status "https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/plugins/status.py"
click node_speedtest "https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/plugins/speed_test.py"
click node_telegram_upload "https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/uploads/telegram.py"
click node_drive_upload "https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/uploads/drive/upload.py"

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_bot_client,node_commands,node_settings_ui,node_callbacks,node_status,node_speedtest,node_telegram_user toneBlue
class node_task_router,node_url_download,node_drive_download,node_task_queue toneAmber
class node_audio_rearrange,node_encoding,node_video_tools,node_ffmpeg toneMint
class node_user_settings,node_user_database,node_database toneRose
class node_telegram_upload,node_drive_upload,node_google_drive,node_telegram_service toneIndigo
```

## Components

### Telegram interaction

- [Pyrogram bot](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/__init__.py): `VideoEncoder/__init__.py`
- [Bot commands](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/plugins/start.py): `VideoEncoder/plugins/start.py`
- [Settings menu](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/plugins/settings.py): `VideoEncoder/plugins/settings.py`
- [Interactive callbacks](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/plugins/callbacks_.py): `VideoEncoder/plugins/callbacks_.py`
- [Status and statistics](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/plugins/status.py): `VideoEncoder/plugins/status.py`
- [Speed test](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/plugins/speed_test.py): `VideoEncoder/plugins/speed_test.py`

### Media workflow

- [Task routing](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/tasks.py): `VideoEncoder/utils/tasks.py`
- [Direct URL download](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/helper.py): `VideoEncoder/utils/helper.py`
- [Drive download](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/uploads/drive/download.py): `VideoEncoder/utils/uploads/drive/download.py`
- [Task queue](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/plugins/queue.py): `VideoEncoder/plugins/queue.py`

### Media processing

- [Audio rearrangement](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/video_utils/audio_selector.py): `VideoEncoder/video_utils/audio_selector.py`
- [Encoding and media options](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/encoding.py): `VideoEncoder/utils/encoding.py`
- [Stream and video tools](https://github.com/jangilimahesh/encoding-bot/tree/audioswap/VideoEncoder/video_utils): `VideoEncoder/video_utils`
- **FFmpeg tools**

### Settings and state

- [Encoding settings](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/settings.py): `VideoEncoder/utils/settings.py`
- [User database access](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/database/access_db.py): `VideoEncoder/utils/database/access_db.py`
- [MongoDB storage](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/database/database.py): `VideoEncoder/utils/database/database.py`

### Delivery and integrations

- [Telegram upload](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/uploads/telegram.py): `VideoEncoder/utils/uploads/telegram.py`
- [Drive upload](https://github.com/jangilimahesh/encoding-bot/blob/audioswap/VideoEncoder/utils/uploads/drive/upload.py): `VideoEncoder/utils/uploads/drive/upload.py`
- **Google Drive**
- **Telegram**

### Other components

- **Telegram user**

## Connections

- Telegram user → Pyrogram bot: sends commands (evidence: `README.md`)
- Pyrogram bot → Bot commands: loads plugins (evidence: `VideoEncoder/__init__.py`)
- Bot commands → Task routing: routes media tasks (evidence: `VideoEncoder/utils/tasks.py`)
- Task routing → Direct URL download: downloads direct URLs (evidence: `VideoEncoder/utils/tasks.py`)
- Task routing → Drive download: downloads Drive files (evidence: `VideoEncoder/utils/tasks.py`)
- Task routing → Audio rearrangement: opens audio menu (evidence: `VideoEncoder/utils/tasks.py`)
- Task routing → Encoding and media options: starts encoding (evidence: `VideoEncoder/utils/tasks.py`)
- Task routing → Stream and video tools: supports media tasks (evidence: `VideoEncoder/utils/tasks.py`)
- Encoding and media options → FFmpeg tools: processes media (evidence: `README.md`)
- Audio rearrangement → Encoding and media options: provides stream order (evidence: `VideoEncoder/utils/tasks.py`)
- Settings menu → Encoding settings: uses settings (evidence: `VideoEncoder/plugins/settings.py`)
- Interactive callbacks → Encoding settings: handles settings actions (evidence: `VideoEncoder/plugins/callbacks_.py`)
- Interactive callbacks → Audio rearrangement: handles audio actions (evidence: `VideoEncoder/plugins/callbacks_.py`)
- Task queue → Task routing: coordinates requests
- User database access → MongoDB storage: creates database access (evidence: `VideoEncoder/utils/database/access_db.py`)
- Status and statistics → User database access: counts users (evidence: `VideoEncoder/plugins/status.py`)
- Speed test → Telegram: reports results
- Encoding and media options → Telegram upload: passes encoded file (evidence: `VideoEncoder/utils/uploads/telegram.py`)
- Encoding and media options → Drive upload: offers Drive delivery
- Telegram upload → Telegram: uploads results (evidence: `VideoEncoder/utils/uploads/telegram.py`)
- Drive upload → Google Drive: uploads files (evidence: `VideoEncoder/utils/uploads/drive/upload.py`)
