How telegramdesktop/tdesktop works
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: window_session_controller.cpp Session window · storage_account.cpp Account storage · main_session.h Main session · data_session.h Session data
Components 19
Desktop interface
- Session window
Telegram/SourceFiles/window/window_session_controller.cpp - Application services
Telegram/SourceFiles/core/application.h - Privacy settings
Telegram/SourceFiles/settings/settings_privacy_controllers.cpp
Messaging runtime
- API orchestration
Telegram/SourceFiles/apiwrap.h - MTProto transport
Telegram/SourceFiles/mtproto/sender.h - Main session
Telegram/SourceFiles/main/main_session.h - Session data
Telegram/SourceFiles/data/data_session.h - Conversation history
Telegram/SourceFiles/history/history.h - User profiles
Telegram/SourceFiles/data/data_user.h
Account and storage
- Account storage
Telegram/SourceFiles/storage/storage_account.cpp - Local storage settings
Telegram/SourceFiles/storage/localstorage.cpp - Storage utilities
Telegram/SourceFiles/storage/details/storage_file_utilities.cpp
Client features
- Voice and video calls
Telegram/SourceFiles/calls/calls_instance.cpp - Data export
Telegram/SourceFiles/export/export_controller.cpp - Inline bot storage
Telegram/SourceFiles/inline_bots/inline_bot_storage.cpp - Identity verification
Telegram/SourceFiles/passport/passport_form_controller.cpp - Wallet engine
Telegram/SourceFiles/wallet/wallet_engine.cpp
Other components
- Desktop user
- Telegram service
Connections 16
- Desktop user → Session window: uses
README.md - Session window → API orchestration: dispatches requests
Telegram/SourceFiles/window/window_session_controller.cpp - API orchestration → MTProto transport: uses transport
Telegram/SourceFiles/apiwrap.h - MTProto transport → Telegram service: communicates via
README.md - Main session → Account storage: accesses account data
Telegram/SourceFiles/main/main_session.h - Account storage → Storage utilities: uses utilities
Telegram/SourceFiles/storage/storage_account.cpp - Local storage settings → Account storage: reads account state
Telegram/SourceFiles/storage/localstorage.cpp - Privacy settings → API orchestration: uses API
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
Telegram/SourceFiles/inline_bots/inline_bot_storage.cpp - Session window → Identity verification: opens verification
Telegram/SourceFiles/passport/passport_form_controller.cpp - Wallet engine → Account storage: persists account data
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
Telegram/SourceFiles/main/main_session.h