# tgx-android/telegram-x architecture

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

- Interactive diagram: https://gitdiagram.com/tgx-android/telegram-x
- Repository: https://github.com/tgx-android/telegram-x

## Overview

Telegram X is an Android Telegram client built on TDLib. The main user path is opening a chat, loading and displaying its messages, and composing or sending a reply through the chat UI and TDLib. The repository also includes media browsing, voice/video calling, notifications and push, and account, theme, and settings support. Several subsystem links below are documented by the README or visible in the SOURCE INDEX; unsampled implementation details are not asserted as verified call paths.

Main entry points: [`app/src/main/java/org/thunderdog/challegram/ui/MessagesController.java`](https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/ui/MessagesController.java) (Chat screen), [`app/src/main/java/org/thunderdog/challegram/telegram/Tdlib.java`](https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/telegram/Tdlib.java) (TDLib client), [`app/src/main/java/org/thunderdog/challegram/BaseActivity.java`](https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/BaseActivity.java) (App activity), [`app/src/main/java/org/thunderdog/challegram/component/chat/MessagesManager.java`](https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/component/chat/MessagesManager.java) (Message handling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Android app"]
  node_activity["App activity<br/>[BaseActivity.java]"]
  node_navigation["Navigation"]
end

subgraph group_chat["Chats and messaging"]
  node_chatui["Chat screen"]
  node_messages["Message handling"]
  node_send["Message sending<br/>[SendHelper.java]"]
  node_message_model["Message models<br/>[TGMessage.java]"]
  node_dialogs["Chat list<br/>[ChatsAdapter.java]"]
end

subgraph group_media["Media and calls"]
  node_media_picker["Media attachments<br/>[MediaLayout.java]"]
  node_media_viewer["Media viewer"]
  node_calls["Voice and video calls<br/>[CallManager.java]"]
  node_call_service["Call service<br/>[TGCallService.java]"]
end

subgraph group_platform["Platform services"]
  node_push["Push notifications"]
  node_push_bridge["Push bridge"]
  node_huawei_push["Huawei push"]
  node_theme["Themes and display<br/>[Theme.java]"]
end

subgraph group_core["TDLib and shared core"]
  node_accounts["Accounts<br/>[TdlibManager.java]"]
  node_tdlib["TDLib client<br/>[Tdlib.java]"]
end

node_user(("Telegram user"))
node_telegram[("Telegram service")]

node_user -.->|"uses"| node_activity
node_activity -.->|"hosts"| node_navigation
node_navigation -.->|"opens"| node_chatui
node_user -.->|"selects chat"| node_chatui
node_chatui -.->|"manages messages"| node_messages
node_chatui -.->|"composes with"| node_send
node_messages -->|"uses models"| node_message_model
node_chatui -.->|"shows chats"| node_dialogs
node_chatui -->|"attaches media"| node_media_picker
node_user -.->|"views media"| node_media_viewer
node_user -->|"starts call"| node_calls
node_calls -->|"uses service"| node_call_service
node_push -->|"delegates"| node_push_bridge
node_huawei_push -->|"delegates"| node_push_bridge
node_accounts -.->|"manages clients"| node_tdlib
node_tdlib -->|"communicates via"| node_telegram
node_send -.->|"submits messages"| node_tdlib
node_tdlib -.->|"supplies updates"| node_messages
node_activity -.->|"uses appearance"| node_theme

click node_activity "https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/BaseActivity.java"
click node_navigation "https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/navigation/ViewController.java"
click node_chatui "https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/ui/MessagesController.java"
click node_messages "https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/component/chat/MessagesManager.java"
click node_send "https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/component/chat/SendHelper.java"
click node_message_model "https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/data/TGMessage.java"
click node_dialogs "https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/component/dialogs/ChatsAdapter.java"
click node_media_picker "https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/component/attach/MediaLayout.java"
click node_media_viewer "https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/mediaview/MediaViewController.java"
click node_calls "https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/telegram/CallManager.java"
click node_call_service "https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/service/TGCallService.java"
click node_push "https://github.com/tgx-android/telegram-x/blob/main/app/src/google/main/java/org/thunderdog/challegram/push/DefaultFirebaseMessagingService.kt"
click node_push_bridge "https://github.com/tgx-android/telegram-x/blob/main/extension/bridge/src/main/kotlin/tgx/bridge/PushManagerBridge.kt"
click node_huawei_push "https://github.com/tgx-android/telegram-x/blob/main/extension/hms/src/main/kotlin/tgx/extension/hms/HuaweiPushListenerService.kt"
click node_theme "https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/theme/Theme.java"
click node_accounts "https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/telegram/TdlibManager.java"
click node_tdlib "https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/telegram/Tdlib.java"

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_activity,node_navigation,node_user toneBlue
class node_chatui,node_messages,node_send,node_message_model,node_dialogs,node_telegram toneAmber
class node_media_picker,node_media_viewer,node_calls,node_call_service toneMint
class node_push,node_push_bridge,node_huawei_push,node_theme toneRose
class node_accounts,node_tdlib toneIndigo
```

## Components

### Android app

- [App activity](https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/BaseActivity.java): `app/src/main/java/org/thunderdog/challegram/BaseActivity.java`
- [Navigation](https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/navigation/ViewController.java): `app/src/main/java/org/thunderdog/challegram/navigation/ViewController.java`

### Chats and messaging

- [Chat screen](https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/ui/MessagesController.java): `app/src/main/java/org/thunderdog/challegram/ui/MessagesController.java`
- [Message handling](https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/component/chat/MessagesManager.java): `app/src/main/java/org/thunderdog/challegram/component/chat/MessagesManager.java`
- [Message sending](https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/component/chat/SendHelper.java): `app/src/main/java/org/thunderdog/challegram/component/chat/SendHelper.java`
- [Message models](https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/data/TGMessage.java): `app/src/main/java/org/thunderdog/challegram/data/TGMessage.java`
- [Chat list](https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/component/dialogs/ChatsAdapter.java): `app/src/main/java/org/thunderdog/challegram/component/dialogs/ChatsAdapter.java`

### Media and calls

- [Media attachments](https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/component/attach/MediaLayout.java): `app/src/main/java/org/thunderdog/challegram/component/attach/MediaLayout.java`
- [Media viewer](https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/mediaview/MediaViewController.java): `app/src/main/java/org/thunderdog/challegram/mediaview/MediaViewController.java`
- [Voice and video calls](https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/telegram/CallManager.java): `app/src/main/java/org/thunderdog/challegram/telegram/CallManager.java`
- [Call service](https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/service/TGCallService.java): `app/src/main/java/org/thunderdog/challegram/service/TGCallService.java`

### Platform services

- [Push notifications](https://github.com/tgx-android/telegram-x/blob/main/app/src/google/main/java/org/thunderdog/challegram/push/DefaultFirebaseMessagingService.kt): `app/src/google/main/java/org/thunderdog/challegram/push/DefaultFirebaseMessagingService.kt`
- [Push bridge](https://github.com/tgx-android/telegram-x/blob/main/extension/bridge/src/main/kotlin/tgx/bridge/PushManagerBridge.kt): `extension/bridge/src/main/kotlin/tgx/bridge/PushManagerBridge.kt`
- [Huawei push](https://github.com/tgx-android/telegram-x/blob/main/extension/hms/src/main/kotlin/tgx/extension/hms/HuaweiPushListenerService.kt): `extension/hms/src/main/kotlin/tgx/extension/hms/HuaweiPushListenerService.kt`
- [Themes and display](https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/theme/Theme.java): `app/src/main/java/org/thunderdog/challegram/theme/Theme.java`

### TDLib and shared core

- [Accounts](https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/telegram/TdlibManager.java): `app/src/main/java/org/thunderdog/challegram/telegram/TdlibManager.java`
- [TDLib client](https://github.com/tgx-android/telegram-x/blob/main/app/src/main/java/org/thunderdog/challegram/telegram/Tdlib.java): `app/src/main/java/org/thunderdog/challegram/telegram/Tdlib.java`

### Other components

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

## Connections

- Telegram user → App activity: uses
- App activity → Navigation: hosts (evidence: `app/src/main/java/org/thunderdog/challegram/BaseActivity.java`)
- Navigation → Chat screen: opens
- Telegram user → Chat screen: selects chat
- Chat screen → Message handling: manages messages (evidence: `app/src/main/java/org/thunderdog/challegram/ui/MessagesController.java`)
- Chat screen → Message sending: composes with
- Message handling → Message models: uses models (evidence: `app/src/main/java/org/thunderdog/challegram/component/chat/MessagesManager.java`)
- Chat screen → Chat list: shows chats
- Chat screen → Media attachments: attaches media (evidence: `app/src/main/java/org/thunderdog/challegram/ui/MessagesController.java`)
- Telegram user → Media viewer: views media
- Telegram user → Voice and video calls: starts call (evidence: `app/src/main/java/org/thunderdog/challegram/telegram/CallManager.java`)
- Voice and video calls → Call service: uses service (evidence: `app/src/main/java/org/thunderdog/challegram/telegram/CallManager.java`)
- Push notifications → Push bridge: delegates (evidence: `app/src/google/main/java/org/thunderdog/challegram/push/DefaultFirebaseMessagingService.kt`)
- Huawei push → Push bridge: delegates (evidence: `extension/hms/src/main/kotlin/tgx/extension/hms/HuaweiPushListenerService.kt`)
- Accounts → TDLib client: manages clients (evidence: `app/src/main/java/org/thunderdog/challegram/telegram/TdlibManager.java`)
- TDLib client → Telegram service: communicates via (evidence: `README.md`)
- Message sending → TDLib client: submits messages
- TDLib client → Message handling: supplies updates (evidence: `app/src/main/java/org/thunderdog/challegram/component/chat/MessagesManager.java`)
- App activity → Themes and display: uses appearance
