# rustdesk/rustdesk architecture

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

- Interactive diagram: https://gitdiagram.com/rustdesk/rustdesk
- Repository: https://github.com/rustdesk/rustdesk
- Video tour (about a minute): https://gitdiagram.com/rustdesk/rustdesk/video

## Overview

RustDesk is a cross-platform remote desktop application. The principal workflow is that a user initiates a peer session in the UI, the client establishes connectivity using rendezvous/relay infrastructure, and the remote host serves screen, input, and related session capabilities. The graph preserves major documented and indexed capabilities while limiting connections to relationships visible in the README or SOURCE INDEX. Some subsystems are represented at directory level because their implementation files were not sampled.

Main entry points: [`src/client.rs`](https://github.com/rustdesk/rustdesk/blob/master/src/client.rs) (Session Client), [`src/server.rs`](https://github.com/rustdesk/rustdesk/blob/master/src/server.rs) (Host Server), [`src/server/display_service.rs`](https://github.com/rustdesk/rustdesk/blob/master/src/server/display_service.rs) (Display Service), [`src/server/input_service.rs`](https://github.com/rustdesk/rustdesk/blob/master/src/server/input_service.rs) (Remote Input)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_flutter["Flutter UI<br/>[flutter.rs]"]
  node_ui_api["UI Interface<br/>[ui_interface.rs]"]
  node_ipc["Local IPC<br/>[ipc.rs]"]
end

subgraph group_connect["Session Connectivity"]
  node_client["Session Client<br/>[client.rs]"]
  node_rendezvous["Rendezvous Mediator"]
  node_relay{{"Rendezvous / Relay"}}
end

subgraph group_host["Remote Host"]
  node_server["Host Server<br/>[server.rs]"]
  node_display["Display Service<br/>[display_service.rs]"]
  node_capture["Screen Capture<br/>[drm_capturer.rs]"]
  node_input["Remote Input<br/>[input_service.rs]"]
  node_uinput["Input Device<br/>[uinput.rs]"]
end

subgraph group_features["Session Features"]
  node_clipboard["Clipboard<br/>[clipboard.rs]"]
  node_file_transfer["File Transfer<br/>[fs.rs]"]
  node_audio["Audio Session<br/>[audio_service.rs]"]
  node_terminal["Terminal Session"]
  node_trusted[("Trusted Devices<br/>[config.rs]")]
end

subgraph group_platform["Platform Support"]
  node_platform_api["Platform APIs<br/>[mod.rs]"]
  node_virtual_display["Virtual Display"]
end

node_user(("User"))

node_user -->|"starts session"| node_flutter
node_flutter -->|"creates session"| node_client
node_flutter -->|"emits UI events"| node_ui_api
node_client -->|"uses IPC"| node_ipc
node_client -->|"uses device trust"| node_trusted
node_client -->|"connects via"| node_relay
node_rendezvous -->|"mediates peers"| node_relay
node_server -->|"starts mediator"| node_rendezvous
node_server -->|"registers services"| node_display
node_server -->|"registers services"| node_input
node_server -->|"registers services"| node_audio
node_server -->|"registers services"| node_terminal
node_display -->|"uses capturer"| node_capture
node_display -->|"manages displays"| node_virtual_display
node_display -->|"uses platform"| node_platform_api
node_input -->|"dispatches input"| node_uinput
node_input -->|"uses platform"| node_platform_api
node_input -->|"uses clipboard"| node_clipboard
node_client -->|"uses clipboard"| node_clipboard
node_client -->|"uses file transfer"| node_file_transfer
node_client -->|"handles playback"| node_audio
node_ipc -->|"updates options"| node_trusted

click node_flutter "https://github.com/rustdesk/rustdesk/blob/master/src/flutter.rs"
click node_ui_api "https://github.com/rustdesk/rustdesk/blob/master/src/ui_interface.rs"
click node_client "https://github.com/rustdesk/rustdesk/blob/master/src/client.rs"
click node_rendezvous "https://github.com/rustdesk/rustdesk/blob/master/src/rendezvous_mediator.rs"
click node_ipc "https://github.com/rustdesk/rustdesk/blob/master/src/ipc.rs"
click node_server "https://github.com/rustdesk/rustdesk/blob/master/src/server.rs"
click node_display "https://github.com/rustdesk/rustdesk/blob/master/src/server/display_service.rs"
click node_capture "https://github.com/rustdesk/rustdesk/blob/master/src/server/drm_capturer.rs"
click node_input "https://github.com/rustdesk/rustdesk/blob/master/src/server/input_service.rs"
click node_uinput "https://github.com/rustdesk/rustdesk/blob/master/src/server/uinput.rs"
click node_clipboard "https://github.com/rustdesk/rustdesk/blob/master/src/clipboard.rs"
click node_file_transfer "https://github.com/rustdesk/rustdesk/blob/master/libs/base/src/fs.rs"
click node_audio "https://github.com/rustdesk/rustdesk/blob/master/src/server/audio_service.rs"
click node_terminal "https://github.com/rustdesk/rustdesk/blob/master/src/server/terminal_service.rs"
click node_trusted "https://github.com/rustdesk/rustdesk/blob/master/src/trusted_devices/config.rs"
click node_platform_api "https://github.com/rustdesk/rustdesk/blob/master/src/platform/mod.rs"
click node_virtual_display "https://github.com/rustdesk/rustdesk/blob/master/src/virtual_display_manager.rs"

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_flutter,node_ui_api,node_ipc,node_user toneBlue
class node_client,node_rendezvous,node_relay toneAmber
class node_server,node_display,node_capture,node_input,node_uinput toneMint
class node_clipboard,node_file_transfer,node_audio,node_terminal,node_trusted toneRose
class node_platform_api,node_virtual_display toneIndigo
```

## Components

### Application

- [Flutter UI](https://github.com/rustdesk/rustdesk/blob/master/src/flutter.rs): `src/flutter.rs`
- [UI Interface](https://github.com/rustdesk/rustdesk/blob/master/src/ui_interface.rs): `src/ui_interface.rs`
- [Local IPC](https://github.com/rustdesk/rustdesk/blob/master/src/ipc.rs): `src/ipc.rs`

### Session Connectivity

- [Session Client](https://github.com/rustdesk/rustdesk/blob/master/src/client.rs): `src/client.rs`
- [Rendezvous Mediator](https://github.com/rustdesk/rustdesk/blob/master/src/rendezvous_mediator.rs): `src/rendezvous_mediator.rs`
- **Rendezvous / Relay**

### Remote Host

- [Host Server](https://github.com/rustdesk/rustdesk/blob/master/src/server.rs): `src/server.rs`
- [Display Service](https://github.com/rustdesk/rustdesk/blob/master/src/server/display_service.rs): `src/server/display_service.rs`
- [Screen Capture](https://github.com/rustdesk/rustdesk/blob/master/src/server/drm_capturer.rs): `src/server/drm_capturer.rs`
- [Remote Input](https://github.com/rustdesk/rustdesk/blob/master/src/server/input_service.rs): `src/server/input_service.rs`
- [Input Device](https://github.com/rustdesk/rustdesk/blob/master/src/server/uinput.rs): `src/server/uinput.rs`

### Session Features

- [Clipboard](https://github.com/rustdesk/rustdesk/blob/master/src/clipboard.rs): `src/clipboard.rs`
- [File Transfer](https://github.com/rustdesk/rustdesk/blob/master/libs/base/src/fs.rs): `libs/base/src/fs.rs`
- [Audio Session](https://github.com/rustdesk/rustdesk/blob/master/src/server/audio_service.rs): `src/server/audio_service.rs`
- [Terminal Session](https://github.com/rustdesk/rustdesk/blob/master/src/server/terminal_service.rs): `src/server/terminal_service.rs`
- [Trusted Devices](https://github.com/rustdesk/rustdesk/blob/master/src/trusted_devices/config.rs): `src/trusted_devices/config.rs`

### Platform Support

- [Platform APIs](https://github.com/rustdesk/rustdesk/blob/master/src/platform/mod.rs): `src/platform/mod.rs`
- [Virtual Display](https://github.com/rustdesk/rustdesk/blob/master/src/virtual_display_manager.rs): `src/virtual_display_manager.rs`

### Other components

- **User**

## Connections

- User → Flutter UI: starts session
- Flutter UI → Session Client: creates session (evidence: `src/flutter.rs`)
- Flutter UI → UI Interface: emits UI events (evidence: `src/flutter.rs`)
- Session Client → Local IPC: uses IPC (evidence: `src/client.rs`)
- Session Client → Trusted Devices: uses device trust (evidence: `src/client.rs`)
- Session Client → Rendezvous / Relay: connects via
- Rendezvous Mediator → Rendezvous / Relay: mediates peers
- Host Server → Rendezvous Mediator: starts mediator (evidence: `src/server.rs`)
- Host Server → Display Service: registers services (evidence: `src/server.rs`)
- Host Server → Remote Input: registers services (evidence: `src/server.rs`)
- Host Server → Audio Session: registers services (evidence: `src/server.rs`)
- Host Server → Terminal Session: registers services (evidence: `src/server.rs`)
- Display Service → Screen Capture: uses capturer (evidence: `src/server/display_service.rs`)
- Display Service → Virtual Display: manages displays (evidence: `src/server/display_service.rs`)
- Display Service → Platform APIs: uses platform (evidence: `src/server/display_service.rs`)
- Remote Input → Input Device: dispatches input (evidence: `src/server/input_service.rs`)
- Remote Input → Platform APIs: uses platform (evidence: `src/server/input_service.rs`)
- Remote Input → Clipboard: uses clipboard (evidence: `src/server/input_service.rs`)
- Session Client → Clipboard: uses clipboard (evidence: `src/client.rs`)
- Session Client → File Transfer: uses file transfer (evidence: `src/client.rs`)
- Session Client → Audio Session: handles playback (evidence: `src/client.rs`)
- Local IPC → Trusted Devices: updates options (evidence: `src/ipc.rs`)
