# anshupriyan/discap architecture

> Architecture diagram of the GitHub repository anshupriyan/discap, 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/anshupriyan/discap
- Repository: https://github.com/anshupriyan/discap

## Overview

Discap streams a Windows virtual display to an Android tablet over USB/ADB, then returns tablet touch input to Windows. The host creates the display, captures frames, selects LZ4 or NVENC encoding, and sends protocol packets; Android receives, decodes, and renders them, while cursor overlays and touch input support the drawing-tablet workflow. The host also manages USB/ADB connectivity and injects received input. Some host orchestration details are only partially excerpted, so documented pipeline links cite the README; unsampled implementation details are not inferred.

Main entry points: [`src/Discap.Host/Program.cs`](https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Program.cs) (Host orchestrator), [`src/Discap.Android/app/src/main/java/com/discap/android/receiver/SocketReceiver.kt`](https://github.com/anshupriyan/discap/blob/main/src/Discap.Android/app/src/main/java/com/discap/android/receiver/SocketReceiver.kt) (Socket receiver), [`src/Discap.Host/Capture/FrameBuffer.cs`](https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Capture/FrameBuffer.cs) (Frame buffer), [`src/Discap.Android/app/src/main/java/com/discap/android/MainActivity.kt`](https://github.com/anshupriyan/discap/blob/main/src/Discap.Android/app/src/main/java/com/discap/android/MainActivity.kt) (Android activity)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_display["Virtual display"]
  node_virtual_manager["Display lifecycle"]
  node_parsec["Parsec VDD API<br/>[ParsecVdd.cs]"]
end

subgraph group_host["Host streaming"]
  node_desktop["Desktop capture"]
  node_frame["Frame buffer<br/>[FrameBuffer.cs]"]
  node_analyzer["Frame analysis<br/>[FrameAnalyzer.cs]"]
  node_lz4["LZ4 compression<br/>[Lz4Compressor.cs]"]
  node_encoder["NVENC encoder<br/>[HardwareEncoder.cs]"]
  node_ffmpeg["FFmpeg encoder<br/>[FfmpegEncoder.cs]"]
  node_program["Host orchestrator<br/>[Program.cs]"]
  node_packet["Frame protocol<br/>[PacketHeader.cs]"]
end

subgraph group_transport["USB transport"]
  node_adb["ADB forwarding<br/>[AdbManager.cs]"]
  node_server["Stream server<br/>[StreamServer.cs]"]
  node_usb["USB transport<br/>[UsbTransport.cs]"]
end

subgraph group_android["Android client"]
  node_android["Android activity<br/>[MainActivity.kt]"]
  node_socket["Socket receiver<br/>[SocketReceiver.kt]"]
  node_h264["H.264 decoder<br/>[H264Decoder.kt]"]
  node_lz4dec["LZ4 decoder<br/>[Lz4Decoder.kt]"]
  node_renderer["OpenGL renderer<br/>[OpenGLRenderer.kt]"]
  node_cursor["Cursor manager<br/>[CursorManager.kt]"]
  node_overlay["Cursor overlay"]
end

subgraph group_input["Input return"]
  node_touchpacket["Touch packet<br/>[TouchPacket.kt]"]
  node_injector["Touch injection<br/>[TouchInjector.cs]"]
  node_mouse["Mouse injection<br/>[MouseInjector.cs]"]
end

node_operator(("PC operator"))
node_android_device(("Android tablet"))
node_windows["Windows display system"]
node_adb_service["ADB service"]

node_operator -->|"starts streaming"| node_program
node_program -->|"creates display"| node_virtual_manager
node_virtual_manager -->|"controls driver"| node_parsec
node_parsec -->|"adds monitor"| node_windows
node_desktop -->|"produces frames"| node_frame
node_frame -->|"analyzes changes"| node_analyzer
node_program -->|"captures display"| node_desktop
node_program -->|"compresses static frames"| node_lz4
node_program -->|"encodes motion"| node_encoder
node_encoder -->|"reads frames"| node_frame
node_ffmpeg -->|"reads frames"| node_frame
node_program -->|"packages frames"| node_packet
node_program -->|"sets up forwarding"| node_adb
node_adb -->|"forwards socket"| node_adb_service
node_program -->|"starts stream"| node_server
node_program -->|"streams over USB"| node_usb
node_usb -->|"transfers packets"| node_android_device
node_server -->|"sends frame stream"| node_socket
node_android -->|"starts receiver"| node_socket
node_socket -->|"decodes H.264"| node_h264
node_socket -->|"decodes LZ4"| node_lz4dec
node_socket -->|"renders decoded frames"| node_renderer
node_socket -->|"dispatches cursor packets"| node_cursor
node_cursor -->|"updates overlay"| node_overlay
node_android_device -->|"touches display"| node_android
node_android -->|"builds touch events"| node_touchpacket
node_touchpacket -->|"sends input"| node_socket
node_socket -->|"returns input"| node_program
node_program -->|"injects touch"| node_injector
node_program -->|"injects mouse"| node_mouse
node_injector -->|"injects touch input"| node_windows

click node_virtual_manager "https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Display/VirtualDisplayManager.cs"
click node_parsec "https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Display/ParsecVdd.cs"
click node_desktop "https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Capture/DesktopDuplicator.cs"
click node_frame "https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Capture/FrameBuffer.cs"
click node_analyzer "https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Compression/FrameAnalyzer.cs"
click node_lz4 "https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Compression/Lz4Compressor.cs"
click node_encoder "https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Compression/HardwareEncoder.cs"
click node_ffmpeg "https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Compression/FfmpegEncoder.cs"
click node_program "https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Program.cs"
click node_packet "https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Protocol/PacketHeader.cs"
click node_adb "https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Transport/AdbManager.cs"
click node_server "https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Transport/StreamServer.cs"
click node_usb "https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Network/UsbTransport.cs"
click node_android "https://github.com/anshupriyan/discap/blob/main/src/Discap.Android/app/src/main/java/com/discap/android/MainActivity.kt"
click node_socket "https://github.com/anshupriyan/discap/blob/main/src/Discap.Android/app/src/main/java/com/discap/android/receiver/SocketReceiver.kt"
click node_h264 "https://github.com/anshupriyan/discap/blob/main/src/Discap.Android/app/src/main/java/com/discap/android/decoder/H264Decoder.kt"
click node_lz4dec "https://github.com/anshupriyan/discap/blob/main/src/Discap.Android/app/src/main/java/com/discap/android/decoder/Lz4Decoder.kt"
click node_renderer "https://github.com/anshupriyan/discap/blob/main/src/Discap.Android/app/src/main/java/com/discap/android/renderer/OpenGLRenderer.kt"
click node_cursor "https://github.com/anshupriyan/discap/blob/main/src/Discap.Android/app/src/main/java/com/discap/android/overlay/CursorManager.kt"
click node_overlay "https://github.com/anshupriyan/discap/blob/main/src/Discap.Android/app/src/main/java/com/discap/android/overlay/CursorOverlayView.kt"
click node_touchpacket "https://github.com/anshupriyan/discap/blob/main/src/Discap.Android/app/src/main/java/com/discap/android/protocol/TouchPacket.kt"
click node_injector "https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Input/TouchInjector.cs"
click node_mouse "https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Input/MouseInjector.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_virtual_manager,node_parsec toneBlue
class node_desktop,node_frame,node_analyzer,node_lz4,node_encoder,node_ffmpeg,node_program,node_packet toneAmber
class node_adb,node_server,node_usb toneMint
class node_android,node_socket,node_h264,node_lz4dec,node_renderer,node_cursor,node_overlay toneRose
class node_touchpacket,node_injector,node_mouse,node_operator,node_android_device,node_windows,node_adb_service toneIndigo
```

## Components

### Virtual display

- [Display lifecycle](https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Display/VirtualDisplayManager.cs): `src/Discap.Host/Display/VirtualDisplayManager.cs`
- [Parsec VDD API](https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Display/ParsecVdd.cs): `src/Discap.Host/Display/ParsecVdd.cs`

### Host streaming

- [Desktop capture](https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Capture/DesktopDuplicator.cs): `src/Discap.Host/Capture/DesktopDuplicator.cs`
- [Frame buffer](https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Capture/FrameBuffer.cs): `src/Discap.Host/Capture/FrameBuffer.cs`
- [Frame analysis](https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Compression/FrameAnalyzer.cs): `src/Discap.Host/Compression/FrameAnalyzer.cs`
- [LZ4 compression](https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Compression/Lz4Compressor.cs): `src/Discap.Host/Compression/Lz4Compressor.cs`
- [NVENC encoder](https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Compression/HardwareEncoder.cs): `src/Discap.Host/Compression/HardwareEncoder.cs`
- [FFmpeg encoder](https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Compression/FfmpegEncoder.cs): `src/Discap.Host/Compression/FfmpegEncoder.cs`
- [Host orchestrator](https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Program.cs): `src/Discap.Host/Program.cs`
- [Frame protocol](https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Protocol/PacketHeader.cs): `src/Discap.Host/Protocol/PacketHeader.cs`

### USB transport

- [ADB forwarding](https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Transport/AdbManager.cs): `src/Discap.Host/Transport/AdbManager.cs`
- [Stream server](https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Transport/StreamServer.cs): `src/Discap.Host/Transport/StreamServer.cs`
- [USB transport](https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Network/UsbTransport.cs): `src/Discap.Host/Network/UsbTransport.cs`

### Android client

- [Android activity](https://github.com/anshupriyan/discap/blob/main/src/Discap.Android/app/src/main/java/com/discap/android/MainActivity.kt): `src/Discap.Android/app/src/main/java/com/discap/android/MainActivity.kt`
- [Socket receiver](https://github.com/anshupriyan/discap/blob/main/src/Discap.Android/app/src/main/java/com/discap/android/receiver/SocketReceiver.kt): `src/Discap.Android/app/src/main/java/com/discap/android/receiver/SocketReceiver.kt`
- [H.264 decoder](https://github.com/anshupriyan/discap/blob/main/src/Discap.Android/app/src/main/java/com/discap/android/decoder/H264Decoder.kt): `src/Discap.Android/app/src/main/java/com/discap/android/decoder/H264Decoder.kt`
- [LZ4 decoder](https://github.com/anshupriyan/discap/blob/main/src/Discap.Android/app/src/main/java/com/discap/android/decoder/Lz4Decoder.kt): `src/Discap.Android/app/src/main/java/com/discap/android/decoder/Lz4Decoder.kt`
- [OpenGL renderer](https://github.com/anshupriyan/discap/blob/main/src/Discap.Android/app/src/main/java/com/discap/android/renderer/OpenGLRenderer.kt): `src/Discap.Android/app/src/main/java/com/discap/android/renderer/OpenGLRenderer.kt`
- [Cursor manager](https://github.com/anshupriyan/discap/blob/main/src/Discap.Android/app/src/main/java/com/discap/android/overlay/CursorManager.kt): `src/Discap.Android/app/src/main/java/com/discap/android/overlay/CursorManager.kt`
- [Cursor overlay](https://github.com/anshupriyan/discap/blob/main/src/Discap.Android/app/src/main/java/com/discap/android/overlay/CursorOverlayView.kt): `src/Discap.Android/app/src/main/java/com/discap/android/overlay/CursorOverlayView.kt`

### Input return

- [Touch packet](https://github.com/anshupriyan/discap/blob/main/src/Discap.Android/app/src/main/java/com/discap/android/protocol/TouchPacket.kt): `src/Discap.Android/app/src/main/java/com/discap/android/protocol/TouchPacket.kt`
- [Touch injection](https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Input/TouchInjector.cs): `src/Discap.Host/Input/TouchInjector.cs`
- [Mouse injection](https://github.com/anshupriyan/discap/blob/main/src/Discap.Host/Input/MouseInjector.cs): `src/Discap.Host/Input/MouseInjector.cs`

### Other components

- **PC operator**
- **Android tablet**
- **Windows display system**
- **ADB service**

## Connections

- PC operator → Host orchestrator: starts streaming (evidence: `README.md`)
- Host orchestrator → Display lifecycle: creates display (evidence: `README.md`)
- Display lifecycle → Parsec VDD API: controls driver (evidence: `src/Discap.Host/Display/VirtualDisplayManager.cs`)
- Parsec VDD API → Windows display system: adds monitor (evidence: `README.md`)
- Desktop capture → Frame buffer: produces frames (evidence: `src/Discap.Host/Capture/DesktopDuplicator.cs`)
- Frame buffer → Frame analysis: analyzes changes (evidence: `src/Discap.Host/Compression/FrameAnalyzer.cs`)
- Host orchestrator → Desktop capture: captures display (evidence: `README.md`)
- Host orchestrator → LZ4 compression: compresses static frames (evidence: `README.md`)
- Host orchestrator → NVENC encoder: encodes motion (evidence: `README.md`)
- NVENC encoder → Frame buffer: reads frames (evidence: `src/Discap.Host/Compression/HardwareEncoder.cs`)
- FFmpeg encoder → Frame buffer: reads frames (evidence: `src/Discap.Host/Compression/FfmpegEncoder.cs`)
- Host orchestrator → Frame protocol: packages frames (evidence: `README.md`)
- Host orchestrator → ADB forwarding: sets up forwarding (evidence: `src/Discap.Host/Program.cs`)
- ADB forwarding → ADB service: forwards socket (evidence: `src/Discap.Host/Transport/AdbManager.cs`)
- Host orchestrator → Stream server: starts stream (evidence: `src/Discap.Host/Program.cs`)
- Host orchestrator → USB transport: streams over USB (evidence: `README.md`)
- USB transport → Android tablet: transfers packets (evidence: `README.md`)
- Stream server → Socket receiver: sends frame stream (evidence: `README.md`)
- Android activity → Socket receiver: starts receiver (evidence: `src/Discap.Android/app/src/main/java/com/discap/android/MainActivity.kt`)
- Socket receiver → H.264 decoder: decodes H.264 (evidence: `src/Discap.Android/app/src/main/java/com/discap/android/receiver/SocketReceiver.kt`)
- Socket receiver → LZ4 decoder: decodes LZ4 (evidence: `src/Discap.Android/app/src/main/java/com/discap/android/receiver/SocketReceiver.kt`)
- Socket receiver → OpenGL renderer: renders decoded frames (evidence: `README.md`)
- Socket receiver → Cursor manager: dispatches cursor packets (evidence: `src/Discap.Android/app/src/main/java/com/discap/android/receiver/SocketReceiver.kt`)
- Cursor manager → Cursor overlay: updates overlay (evidence: `src/Discap.Android/app/src/main/java/com/discap/android/overlay/CursorManager.kt`)
- Android tablet → Android activity: touches display (evidence: `README.md`)
- Android activity → Touch packet: builds touch events (evidence: `src/Discap.Android/app/src/main/java/com/discap/android/MainActivity.kt`)
- Touch packet → Socket receiver: sends input (evidence: `README.md`)
- Socket receiver → Host orchestrator: returns input (evidence: `README.md`)
- Host orchestrator → Touch injection: injects touch (evidence: `README.md`)
- Host orchestrator → Mouse injection: injects mouse (evidence: `src/Discap.Host/Program.cs`)
- Touch injection → Windows display system: injects touch input (evidence: `README.md`)
