# w1ldmaster/discord_telegram_bridge architecture

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

- Interactive diagram: https://gitdiagram.com/w1ldmaster/discord_telegram_bridge
- Repository: https://github.com/w1ldmaster/discord_telegram_bridge

## Overview

This is an asynchronous Discord–Telegram message bridge. `main.py` starts both platform clients and a queue processor; platform handlers convert incoming messages into shared records, and the processor routes them to the opposite platform, downloading and forwarding attachments as needed. The README documents text, media, emoji/formatting, and low-delay forwarding; the sampled handlers show text and several media types, but do not establish full emoji or formatting preservation. The graph reflects the sampled calls and documented bridge workflow; it does not infer unsampled behavior.

Main entry points: [`Project/main.py`](https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/main.py) (Async startup), [`Project/qprocessor.py`](https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/qprocessor.py) (Queue processor), [`Project/discord_bot.py`](https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/discord_bot.py) (Discord intake), [`Project/tg.py`](https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/tg.py) (Telegram intake)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime orchestration"]
  node_runtime["Async startup<br/>[main.py]"]
end

subgraph group_intake["Platform intake"]
  node_discord_intake["Discord intake<br/>[discord_bot.py]"]
  node_telegram_intake["Telegram intake<br/>[tg.py]"]
end

subgraph group_routing["Message routing"]
  node_queue["Message queue<br/>[main_bridge.py]"]
  node_message_model["Message records<br/>[main_bridge.py]"]
  node_processor["Queue processor<br/>[qprocessor.py]"]
end

subgraph group_delivery["Cross-platform delivery"]
  node_discord_delivery["Discord delivery<br/>[qprocessor.py]"]
  node_telegram_delivery["Telegram delivery<br/>[qprocessor.py]"]
end

node_operator(("Bridge operator"))
node_discord(("Discord"))
node_telegram(("Telegram"))
node_media_host(("Media URLs"))

node_operator -->|"starts bridge"| node_runtime
node_runtime -->|"creates bot"| node_discord_intake
node_runtime -->|"creates client"| node_telegram_intake
node_runtime -->|"starts processing"| node_processor
node_discord -->|"sends messages"| node_discord_intake
node_discord_intake -->|"creates records"| node_message_model
node_discord_intake -->|"enqueues"| node_queue
node_telegram -->|"sends messages"| node_telegram_intake
node_telegram_intake -->|"creates records"| node_message_model
node_telegram_intake -->|"enqueues"| node_queue
node_processor -->|"dequeues"| node_queue
node_processor -->|"routes Telegram"| node_discord_delivery
node_processor -->|"routes Discord"| node_telegram_delivery
node_discord_delivery -->|"sends messages"| node_discord
node_telegram_delivery -->|"sends messages"| node_telegram
node_telegram_delivery -->|"downloads media"| node_telegram
node_discord_delivery -->|"downloads attachments"| node_media_host

click node_runtime "https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/main.py"
click node_discord_intake "https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/discord_bot.py"
click node_telegram_intake "https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/tg.py"
click node_queue "https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/main_bridge.py"
click node_message_model "https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/main_bridge.py"
click node_processor "https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/qprocessor.py"
click node_discord_delivery "https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/qprocessor.py"
click node_telegram_delivery "https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/qprocessor.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_runtime toneBlue
class node_discord_intake,node_telegram_intake toneAmber
class node_queue,node_message_model,node_processor toneMint
class node_discord_delivery,node_telegram_delivery toneRose
class node_operator,node_discord,node_telegram,node_media_host toneIndigo
```

## Components

### Runtime orchestration

- [Async startup](https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/main.py): `Project/main.py`

### Platform intake

- [Discord intake](https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/discord_bot.py): `Project/discord_bot.py`
- [Telegram intake](https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/tg.py): `Project/tg.py`

### Message routing

- [Message queue](https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/main_bridge.py): `Project/main_bridge.py`
- [Message records](https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/main_bridge.py): `Project/main_bridge.py`
- [Queue processor](https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/qprocessor.py): `Project/qprocessor.py`

### Cross-platform delivery

- [Discord delivery](https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/qprocessor.py): `Project/qprocessor.py`
- [Telegram delivery](https://github.com/w1ldmaster/discord_telegram_bridge/blob/master/Project/qprocessor.py): `Project/qprocessor.py`

### Other components

- **Bridge operator**
- **Discord**
- **Telegram**
- **Media URLs**

## Connections

- Bridge operator → Async startup: starts bridge (evidence: `README.md`)
- Async startup → Discord intake: creates bot (evidence: `Project/main.py`)
- Async startup → Telegram intake: creates client (evidence: `Project/main.py`)
- Async startup → Queue processor: starts processing (evidence: `Project/main.py`)
- Discord → Discord intake: sends messages (evidence: `README.md`)
- Discord intake → Message records: creates records (evidence: `Project/discord_bot.py`)
- Discord intake → Message queue: enqueues (evidence: `Project/discord_bot.py`)
- Telegram → Telegram intake: sends messages (evidence: `README.md`)
- Telegram intake → Message records: creates records (evidence: `Project/tg.py`)
- Telegram intake → Message queue: enqueues (evidence: `Project/tg.py`)
- Queue processor → Message queue: dequeues (evidence: `Project/qprocessor.py`)
- Queue processor → Discord delivery: routes Telegram (evidence: `Project/qprocessor.py`)
- Queue processor → Telegram delivery: routes Discord (evidence: `Project/qprocessor.py`)
- Discord delivery → Discord: sends messages (evidence: `Project/qprocessor.py`)
- Telegram delivery → Telegram: sends messages (evidence: `Project/qprocessor.py`)
- Telegram delivery → Telegram: downloads media (evidence: `Project/qprocessor.py`)
- Discord delivery → Media URLs: downloads attachments (evidence: `Project/qprocessor.py`)
