How signalapp/signal-desktop works
Signal Desktop is a private desktop messaging client that also supports linked devices, group/direct calling, attachments, and synchronized account state. The principal workflow is user interaction with the desktop UI, which dispatches messaging or calling actions, updates local state, and presents results or notifications. Sampled code most directly establishes the calling orchestration and storage-sync paths; messaging, backup, and platform internals are represented only at supported directory boundaries because their implementations were not sampled.
Main entry points: CallManager.dom.tsx Call Manager · storage.preload.ts Storage Operations · ts Messaging Runtime · Storage.preload.ts Storage Facade
Components 18
User Experience
- Desktop App Shell
app/main.main.ts - Conversation UI
ts/components/ChatsTab.dom.tsx - Messaging Runtime
ts
Calling
- Call Manager
ts/components/CallManager.dom.tsx - Smart Call Manager
ts/state/smart/CallManager.preload.tsx - Calling Engine
ts/calling - Call Link Support
ts/util/callLinkRootKeyToUrl.std.ts
State and Sync
- Storage Facade
ts/textsecure/Storage.preload.ts - Storage Operations
ts/services/storage.preload.ts - Record Conversion
ts/services/storageRecordOps.preload.ts - Local Database
app/sql_channel.main.ts - Storage Protocol
protos/SignalStorage.proto
Platform Services
- Attachment Handling
app/attachments.node.ts - Cryptographic Services
ts/Crypto.node.ts - Desktop Notifications
app/WindowsNotifications.main.ts
Other components
- Desktop User
- Signal Service
- Linked Mobile Device
Connections 18
- Desktop User → Desktop App Shell: uses
- Desktop User → Conversation UI: composes messages
- Desktop User → Call Manager: controls calls
- Conversation UI → Messaging Runtime: dispatches messages
- Messaging Runtime → Attachment Handling: handles media
- Messaging Runtime → Storage Facade: reads state
- Smart Call Manager → Call Manager: renders
- Smart Call Manager → Calling Engine: binds call actions
- Call Manager → Calling Engine: starts or cancels
- Call Manager → Call Link Support: builds call links
- Call Manager → Desktop Notifications: triggers policy
- Storage Facade → Local Database: reads and writes
- Storage Operations → Record Conversion: converts records
- Storage Operations → Signal Service: syncs records
- Record Conversion → Storage Protocol: encodes records
- Storage Operations → Storage Facade: updates state
- Attachment Handling → Cryptographic Services: protects media
- Linked Mobile Device → Signal Service: links and syncs