How tgx-android/telegram-x works
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: MessagesController.java Chat screen · Tdlib.java TDLib client · BaseActivity.java App activity · MessagesManager.java Message handling
Components 19
Android app
- App activity
app/src/main/java/org/thunderdog/challegram/BaseActivity.java - Navigation
app/src/main/java/org/thunderdog/challegram/navigation/ViewController.java
Chats and messaging
- Chat screen
app/src/main/java/org/thunderdog/challegram/ui/MessagesController.java - Message handling
app/src/main/java/org/thunderdog/challegram/component/chat/MessagesManager.java - Message sending
app/src/main/java/org/thunderdog/challegram/component/chat/SendHelper.java - Message models
app/src/main/java/org/thunderdog/challegram/data/TGMessage.java - Chat list
app/src/main/java/org/thunderdog/challegram/component/dialogs/ChatsAdapter.java
Media and calls
- Media attachments
app/src/main/java/org/thunderdog/challegram/component/attach/MediaLayout.java - Media viewer
app/src/main/java/org/thunderdog/challegram/mediaview/MediaViewController.java - Voice and video calls
app/src/main/java/org/thunderdog/challegram/telegram/CallManager.java - Call service
app/src/main/java/org/thunderdog/challegram/service/TGCallService.java
Platform services
- Push notifications
app/src/google/main/java/org/thunderdog/challegram/push/DefaultFirebaseMessagingService.kt - Push bridge
extension/bridge/src/main/kotlin/tgx/bridge/PushManagerBridge.kt - Huawei push
extension/hms/src/main/kotlin/tgx/extension/hms/HuaweiPushListenerService.kt - Themes and display
app/src/main/java/org/thunderdog/challegram/theme/Theme.java
TDLib and shared core
- Accounts
app/src/main/java/org/thunderdog/challegram/telegram/TdlibManager.java - TDLib client
app/src/main/java/org/thunderdog/challegram/telegram/Tdlib.java
Other components
- Telegram user
- Telegram service
Connections 19
- Telegram user → App activity: uses
- App activity → Navigation: hosts
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
app/src/main/java/org/thunderdog/challegram/ui/MessagesController.java - Chat screen → Message sending: composes with
- Message handling → Message models: uses models
app/src/main/java/org/thunderdog/challegram/component/chat/MessagesManager.java - Chat screen → Chat list: shows chats
- Chat screen → Media attachments: attaches media
app/src/main/java/org/thunderdog/challegram/ui/MessagesController.java - Telegram user → Media viewer: views media
- Telegram user → Voice and video calls: starts call
app/src/main/java/org/thunderdog/challegram/telegram/CallManager.java - Voice and video calls → Call service: uses service
app/src/main/java/org/thunderdog/challegram/telegram/CallManager.java - Push notifications → Push bridge: delegates
app/src/google/main/java/org/thunderdog/challegram/push/DefaultFirebaseMessagingService.kt - Huawei push → Push bridge: delegates
extension/hms/src/main/kotlin/tgx/extension/hms/HuaweiPushListenerService.kt - Accounts → TDLib client: manages clients
app/src/main/java/org/thunderdog/challegram/telegram/TdlibManager.java - TDLib client → Telegram service: communicates via
README.md - Message sending → TDLib client: submits messages
- TDLib client → Message handling: supplies updates
app/src/main/java/org/thunderdog/challegram/component/chat/MessagesManager.java - App activity → Themes and display: uses appearance