# telegramdesktop/tdesktop architecture

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

- Interactive diagram: https://gitdiagram.com/telegramdesktop/tdesktop
- Repository: https://github.com/telegramdesktop/tdesktop

## Overview

Telegram Desktop is the official desktop client for Telegram, using the Telegram API and MTProto. A typical workflow begins in the desktop UI, passes through session and API handling, and updates local conversation state and persisted account data. The tree also exposes distinct calling, export, bot, identity-verification, wallet, and settings subsystems. Relationships are limited to those visible in README documentation, excerpts, or SOURCE INDEX references; several feature branches are shown without guessed call paths.

Main entry points: [`Telegram/SourceFiles/window/window_session_controller.cpp`](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/window/window_session_controller.cpp) (Session window), [`Telegram/SourceFiles/storage/storage_account.cpp`](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/storage/storage_account.cpp) (Account storage), [`Telegram/SourceFiles/main/main_session.h`](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/main/main_session.h) (Main session), [`Telegram/SourceFiles/data/data_session.h`](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/data/data_session.h) (Session data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_window["Session window"]
  node_application["Application services<br/>[application.h]"]
  node_settings["Privacy settings"]
end

subgraph group_messaging["Messaging runtime"]
  node_api["API orchestration<br/>[apiwrap.h]"]
  node_mtproto["MTProto transport<br/>[sender.h]"]
  node_session["Main session<br/>[main_session.h]"]
  node_data["Session data<br/>[data_session.h]"]
  node_history["Conversation history<br/>[history.h]"]
  node_users["User profiles<br/>[data_user.h]"]
end

subgraph group_account["Account and storage"]
  node_storage[("Account storage")]
  node_localstorage[("Local storage settings<br/>[localstorage.cpp]")]
  node_storagefiles["Storage utilities"]
end

subgraph group_features["Client features"]
  node_calls["Voice and video calls<br/>[calls_instance.cpp]"]
  node_export["Data export"]
  node_inlinebots[("Inline bot storage")]
  node_passport["Identity verification"]
  node_wallet["Wallet engine<br/>[wallet_engine.cpp]"]
end

node_user(("Desktop user"))
node_telegram{{"Telegram service"}}

node_user -->|"uses"| node_window
node_window -->|"dispatches requests"| node_api
node_api -->|"uses transport"| node_mtproto
node_mtproto -->|"communicates via"| node_telegram
node_session -->|"accesses account data"| node_storage
node_storage -->|"uses utilities"| node_storagefiles
node_localstorage -->|"reads account state"| node_storage
node_settings -->|"uses API"| node_api
node_window -.->|"opens call UI"| node_calls
node_window -.->|"starts export"| node_export
node_session -->|"owns bot data"| node_inlinebots
node_window -->|"opens verification"| node_passport
node_wallet -->|"persists account data"| node_storage
node_data -.->|"manages histories"| node_history
node_data -.->|"manages users"| node_users
node_session -->|"exposes session data"| node_data

click node_window "https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/window/window_session_controller.cpp"
click node_application "https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/core/application.h"
click node_api "https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/apiwrap.h"
click node_mtproto "https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/mtproto/sender.h"
click node_session "https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/main/main_session.h"
click node_data "https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/data/data_session.h"
click node_history "https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/history/history.h"
click node_users "https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/data/data_user.h"
click node_storage "https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/storage/storage_account.cpp"
click node_localstorage "https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/storage/localstorage.cpp"
click node_storagefiles "https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/storage/details/storage_file_utilities.cpp"
click node_settings "https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/settings/settings_privacy_controllers.cpp"
click node_calls "https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/calls/calls_instance.cpp"
click node_export "https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/export/export_controller.cpp"
click node_inlinebots "https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/inline_bots/inline_bot_storage.cpp"
click node_passport "https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/passport/passport_form_controller.cpp"
click node_wallet "https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/wallet/wallet_engine.cpp"

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_window,node_application,node_settings,node_user toneBlue
class node_api,node_mtproto,node_session,node_data,node_history,node_users toneAmber
class node_storage,node_localstorage,node_storagefiles toneMint
class node_calls,node_export,node_inlinebots,node_passport,node_wallet toneRose
class node_telegram toneIndigo
```

## Components

### Desktop interface

- [Session window](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/window/window_session_controller.cpp): `Telegram/SourceFiles/window/window_session_controller.cpp`
- [Application services](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/core/application.h): `Telegram/SourceFiles/core/application.h`
- [Privacy settings](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/settings/settings_privacy_controllers.cpp): `Telegram/SourceFiles/settings/settings_privacy_controllers.cpp`

### Messaging runtime

- [API orchestration](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/apiwrap.h): `Telegram/SourceFiles/apiwrap.h`
- [MTProto transport](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/mtproto/sender.h): `Telegram/SourceFiles/mtproto/sender.h`
- [Main session](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/main/main_session.h): `Telegram/SourceFiles/main/main_session.h`
- [Session data](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/data/data_session.h): `Telegram/SourceFiles/data/data_session.h`
- [Conversation history](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/history/history.h): `Telegram/SourceFiles/history/history.h`
- [User profiles](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/data/data_user.h): `Telegram/SourceFiles/data/data_user.h`

### Account and storage

- [Account storage](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/storage/storage_account.cpp): `Telegram/SourceFiles/storage/storage_account.cpp`
- [Local storage settings](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/storage/localstorage.cpp): `Telegram/SourceFiles/storage/localstorage.cpp`
- [Storage utilities](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/storage/details/storage_file_utilities.cpp): `Telegram/SourceFiles/storage/details/storage_file_utilities.cpp`

### Client features

- [Voice and video calls](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/calls/calls_instance.cpp): `Telegram/SourceFiles/calls/calls_instance.cpp`
- [Data export](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/export/export_controller.cpp): `Telegram/SourceFiles/export/export_controller.cpp`
- [Inline bot storage](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/inline_bots/inline_bot_storage.cpp): `Telegram/SourceFiles/inline_bots/inline_bot_storage.cpp`
- [Identity verification](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/passport/passport_form_controller.cpp): `Telegram/SourceFiles/passport/passport_form_controller.cpp`
- [Wallet engine](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/wallet/wallet_engine.cpp): `Telegram/SourceFiles/wallet/wallet_engine.cpp`

### Other components

- **Desktop user**
- **Telegram service**

## Connections

- Desktop user → Session window: uses (evidence: `README.md`)
- Session window → API orchestration: dispatches requests (evidence: `Telegram/SourceFiles/window/window_session_controller.cpp`)
- API orchestration → MTProto transport: uses transport (evidence: `Telegram/SourceFiles/apiwrap.h`)
- MTProto transport → Telegram service: communicates via (evidence: `README.md`)
- Main session → Account storage: accesses account data (evidence: `Telegram/SourceFiles/main/main_session.h`)
- Account storage → Storage utilities: uses utilities (evidence: `Telegram/SourceFiles/storage/storage_account.cpp`)
- Local storage settings → Account storage: reads account state (evidence: `Telegram/SourceFiles/storage/localstorage.cpp`)
- Privacy settings → API orchestration: uses API (evidence: `Telegram/SourceFiles/settings/settings_privacy_controllers.cpp`)
- Session window → Voice and video calls: opens call UI
- Session window → Data export: starts export
- Main session → Inline bot storage: owns bot data (evidence: `Telegram/SourceFiles/inline_bots/inline_bot_storage.cpp`)
- Session window → Identity verification: opens verification (evidence: `Telegram/SourceFiles/passport/passport_form_controller.cpp`)
- Wallet engine → Account storage: persists account data (evidence: `Telegram/SourceFiles/wallet/wallet_engine.cpp`)
- Session data → Conversation history: manages histories
- Session data → User profiles: manages users
- Main session → Session data: exposes session data (evidence: `Telegram/SourceFiles/main/main_session.h`)
