# maze-mei/dx-manager architecture

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

- Interactive diagram: https://gitdiagram.com/maze-mei/dx-manager
- Repository: https://github.com/maze-mei/dx-manager

## Overview

DX Manager is a desktop application for running Samsung DeX and independent Android app windows across connected Galaxy phones. The main workflow is to connect a phone, choose a display mode or app profile, start a session through scrcpy, and use capture and file-transfer tools. The Windows app also coordinates wireless ADB and an optional Android Companion for phone-to-PC transfers and cleanup controls. The README documents the product workflow; sampled source and the source index support several internal links, while links to unsampled subsystems are cited only where documented.

Main entry points: [`DexManager/Forms/MainForm.cs`](https://github.com/maze-mei/dx-manager/blob/main/DexManager/Forms/MainForm.cs) (Main window), [`DexManager.Core/Services/DexOrchestrator.cs`](https://github.com/maze-mei/dx-manager/blob/main/DexManager.Core/Services/DexOrchestrator.cs) (Session orchestration), [`DexManager.Core/Services/ScrcpyService.cs`](https://github.com/maze-mei/dx-manager/blob/main/DexManager.Core/Services/ScrcpyService.cs) (scrcpy sessions), [`companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/MainActivity.java`](https://github.com/maze-mei/dx-manager/blob/main/companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/MainActivity.java) (Android Companion)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop experience"]
  node_main["Main window<br/>[MainForm.cs]"]
  node_capture["Capture workflow"]
  node_mini["Mini control bar"]
  node_settings["Settings UI<br/>[SettingsForm.cs]"]
end

subgraph group_devices["Device and sessions"]
  node_adb["ADB connectivity<br/>[AdbService.cs]"]
  node_wireless["Wireless ADB"]
  node_monitor["Device monitoring"]
  node_orchestrator["Session orchestration<br/>[DexOrchestrator.cs]"]
  node_scrcpy["scrcpy sessions<br/>[ScrcpyService.cs]"]
  node_single_window["App windows"]
  node_native_dex["Native DeX"]
  node_transfers["PC-to-phone transfer"]
end

subgraph group_phone["Phone integration"]
end

subgraph group_companion["DX Companion"]
  node_companion["Android Companion<br/>[MainActivity.java]"]
  node_phone_transfer["Phone-to-PC transfer"]
  node_guardian["Session guardian"]
  node_cleanup["Display cleanup"]
  node_companion_controls["Quick controls"]
end

subgraph group_support["Settings and support"]
  node_settings_service["Settings persistence<br/>[SettingsService.cs]"]
  node_diagnostics["Diagnostics"]
  node_updates["Update checks"]
end

node_user(("Desktop user"))
node_phone(("Galaxy phone"))
node_scrcpy_external["scrcpy runtime"]
node_github["GitHub releases"]

node_user -->|"operates"| node_main
node_main -->|"loads settings"| node_settings_service
node_main -->|"starts capture"| node_capture
node_main -->|"manages controls"| node_mini
node_settings -.->|"saves settings"| node_settings_service
node_main -.->|"shows devices"| node_monitor
node_main -.->|"starts DeX"| node_orchestrator
node_orchestrator -.->|"runs commands"| node_adb
node_wireless -.->|"configures connection"| node_adb
node_orchestrator -.->|"starts native mode"| node_native_dex
node_orchestrator -.->|"starts sessions"| node_scrcpy
node_orchestrator -.->|"starts app windows"| node_single_window
node_scrcpy -->|"launches"| node_scrcpy_external
node_scrcpy -->|"streams display"| node_phone
node_capture -->|"reports result"| node_main
node_user -->|"drops files"| node_transfers
node_transfers -->|"sends files"| node_phone
node_phone -->|"uses optional app"| node_companion
node_companion -->|"initiates transfer"| node_phone_transfer
node_phone_transfer -->|"sends files to PC"| node_main
node_companion -->|"manages session"| node_guardian
node_guardian -->|"requests cleanup"| node_cleanup
node_companion_controls -->|"runs cleanup"| node_cleanup
node_user -.->|"requests report"| node_diagnostics
node_main -.->|"shows updates"| node_updates
node_updates -->|"checks releases"| node_github

click node_main "https://github.com/maze-mei/dx-manager/blob/main/DexManager/Forms/MainForm.cs"
click node_capture "https://github.com/maze-mei/dx-manager/blob/main/DexManager/Services/CaptureCoordinator.cs"
click node_mini "https://github.com/maze-mei/dx-manager/blob/main/DexManager/Services/MiniControlBarManager.cs"
click node_settings "https://github.com/maze-mei/dx-manager/blob/main/DexManager/Forms/SettingsForm.cs"
click node_settings_service "https://github.com/maze-mei/dx-manager/blob/main/DexManager/Services/SettingsService.cs"
click node_adb "https://github.com/maze-mei/dx-manager/blob/main/DexManager.Core/Services/AdbService.cs"
click node_wireless "https://github.com/maze-mei/dx-manager/blob/main/DexManager.Core/Services/WirelessAdbService.cs"
click node_monitor "https://github.com/maze-mei/dx-manager/blob/main/DexManager.Core/Services/DeviceMonitorService.cs"
click node_orchestrator "https://github.com/maze-mei/dx-manager/blob/main/DexManager.Core/Services/DexOrchestrator.cs"
click node_scrcpy "https://github.com/maze-mei/dx-manager/blob/main/DexManager.Core/Services/ScrcpyService.cs"
click node_single_window "https://github.com/maze-mei/dx-manager/blob/main/DexManager.Core/Services/SingleWindowService.cs"
click node_native_dex "https://github.com/maze-mei/dx-manager/blob/main/DexManager/Services/NativeDexSessionService.cs"
click node_transfers "https://github.com/maze-mei/dx-manager/blob/main/DexManager.Core/Services/FileTransferCoordinator.cs"
click node_companion "https://github.com/maze-mei/dx-manager/blob/main/companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/MainActivity.java"
click node_phone_transfer "https://github.com/maze-mei/dx-manager/blob/main/companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/PhoneTransferService.java"
click node_guardian "https://github.com/maze-mei/dx-manager/blob/main/companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/SessionGuardianService.java"
click node_cleanup "https://github.com/maze-mei/dx-manager/blob/main/companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/CleanupCoordinator.java"
click node_companion_controls "https://github.com/maze-mei/dx-manager/blob/main/companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/CleanupTileService.java"
click node_diagnostics "https://github.com/maze-mei/dx-manager/blob/main/DexManager.Core/Services/DiagnosticReportService.cs"
click node_updates "https://github.com/maze-mei/dx-manager/blob/main/DexManager/Services/UpdateCheckService.cs"

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_main,node_capture,node_mini,node_settings,node_user toneBlue
class node_adb,node_wireless,node_monitor,node_orchestrator,node_scrcpy,node_single_window,node_native_dex,node_transfers toneAmber
class node_companion,node_phone_transfer,node_guardian,node_cleanup,node_companion_controls toneRose
class node_settings_service,node_diagnostics,node_updates,node_phone,node_scrcpy_external,node_github toneIndigo
```

## Components

### Desktop experience

- [Main window](https://github.com/maze-mei/dx-manager/blob/main/DexManager/Forms/MainForm.cs): `DexManager/Forms/MainForm.cs`
- [Capture workflow](https://github.com/maze-mei/dx-manager/blob/main/DexManager/Services/CaptureCoordinator.cs): `DexManager/Services/CaptureCoordinator.cs`
- [Mini control bar](https://github.com/maze-mei/dx-manager/blob/main/DexManager/Services/MiniControlBarManager.cs): `DexManager/Services/MiniControlBarManager.cs`
- [Settings UI](https://github.com/maze-mei/dx-manager/blob/main/DexManager/Forms/SettingsForm.cs): `DexManager/Forms/SettingsForm.cs`

### Device and sessions

- [ADB connectivity](https://github.com/maze-mei/dx-manager/blob/main/DexManager.Core/Services/AdbService.cs): `DexManager.Core/Services/AdbService.cs`
- [Wireless ADB](https://github.com/maze-mei/dx-manager/blob/main/DexManager.Core/Services/WirelessAdbService.cs): `DexManager.Core/Services/WirelessAdbService.cs`
- [Device monitoring](https://github.com/maze-mei/dx-manager/blob/main/DexManager.Core/Services/DeviceMonitorService.cs): `DexManager.Core/Services/DeviceMonitorService.cs`
- [Session orchestration](https://github.com/maze-mei/dx-manager/blob/main/DexManager.Core/Services/DexOrchestrator.cs): `DexManager.Core/Services/DexOrchestrator.cs`
- [scrcpy sessions](https://github.com/maze-mei/dx-manager/blob/main/DexManager.Core/Services/ScrcpyService.cs): `DexManager.Core/Services/ScrcpyService.cs`
- [App windows](https://github.com/maze-mei/dx-manager/blob/main/DexManager.Core/Services/SingleWindowService.cs): `DexManager.Core/Services/SingleWindowService.cs`
- [Native DeX](https://github.com/maze-mei/dx-manager/blob/main/DexManager/Services/NativeDexSessionService.cs): `DexManager/Services/NativeDexSessionService.cs`
- [PC-to-phone transfer](https://github.com/maze-mei/dx-manager/blob/main/DexManager.Core/Services/FileTransferCoordinator.cs): `DexManager.Core/Services/FileTransferCoordinator.cs`

### DX Companion

- [Android Companion](https://github.com/maze-mei/dx-manager/blob/main/companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/MainActivity.java): `companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/MainActivity.java`
- [Phone-to-PC transfer](https://github.com/maze-mei/dx-manager/blob/main/companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/PhoneTransferService.java): `companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/PhoneTransferService.java`
- [Session guardian](https://github.com/maze-mei/dx-manager/blob/main/companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/SessionGuardianService.java): `companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/SessionGuardianService.java`
- [Display cleanup](https://github.com/maze-mei/dx-manager/blob/main/companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/CleanupCoordinator.java): `companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/CleanupCoordinator.java`
- [Quick controls](https://github.com/maze-mei/dx-manager/blob/main/companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/CleanupTileService.java): `companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/CleanupTileService.java`

### Settings and support

- [Settings persistence](https://github.com/maze-mei/dx-manager/blob/main/DexManager/Services/SettingsService.cs): `DexManager/Services/SettingsService.cs`
- [Diagnostics](https://github.com/maze-mei/dx-manager/blob/main/DexManager.Core/Services/DiagnosticReportService.cs): `DexManager.Core/Services/DiagnosticReportService.cs`
- [Update checks](https://github.com/maze-mei/dx-manager/blob/main/DexManager/Services/UpdateCheckService.cs): `DexManager/Services/UpdateCheckService.cs`

### Other components

- **Desktop user**
- **Galaxy phone**
- **scrcpy runtime**
- **GitHub releases**

## Connections

- Desktop user → Main window: operates (evidence: `README.md`)
- Main window → Settings persistence: loads settings
- Main window → Capture workflow: starts capture (evidence: `DexManager/Forms/MainForm.cs`)
- Main window → Mini control bar: manages controls (evidence: `DexManager/Forms/MainForm.cs`)
- Settings UI → Settings persistence: saves settings
- Main window → Device monitoring: shows devices
- Main window → Session orchestration: starts DeX
- Session orchestration → ADB connectivity: runs commands
- Wireless ADB → ADB connectivity: configures connection
- Session orchestration → Native DeX: starts native mode
- Session orchestration → scrcpy sessions: starts sessions
- Session orchestration → App windows: starts app windows
- scrcpy sessions → scrcpy runtime: launches (evidence: `README.md`)
- scrcpy sessions → Galaxy phone: streams display (evidence: `README.md`)
- Capture workflow → Main window: reports result (evidence: `DexManager/Forms/MainForm.cs`)
- Desktop user → PC-to-phone transfer: drops files (evidence: `README.md`)
- PC-to-phone transfer → Galaxy phone: sends files (evidence: `README.md`)
- Galaxy phone → Android Companion: uses optional app (evidence: `README.md`)
- Android Companion → Phone-to-PC transfer: initiates transfer (evidence: `companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/MainActivity.java`)
- Phone-to-PC transfer → Main window: sends files to PC (evidence: `README.md`)
- Android Companion → Session guardian: manages session (evidence: `companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/MainActivity.java`)
- Session guardian → Display cleanup: requests cleanup (evidence: `companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/SessionGuardianService.java`)
- Quick controls → Display cleanup: runs cleanup (evidence: `companion/source/app/src/main/java/io/github/mazemei/dxdisplaycleanup/CleanupTileService.java`)
- Desktop user → Diagnostics: requests report
- Main window → Update checks: shows updates
- Update checks → GitHub releases: checks releases
