# genymobile/scrcpy architecture

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

- Interactive diagram: https://gitdiagram.com/genymobile/scrcpy
- Repository: https://github.com/genymobile/scrcpy

## Overview

scrcpy is a desktop application for mirroring Android video and audio and controlling the device over USB or TCP/IP; OTG supports physical-input simulation without debugging. The principal path is launch/configuration, device connection and server startup, media capture/transport, desktop playback or recording, and user input sent back to Android. The README documents additional capabilities including camera, virtual displays, V4L2, HID, gamepads, and clipboard. Source excerpts support server orchestration and selected control/service details; several client-side links are documented features rather than inspected call sites.

Main entry points: [`server/src/main/java/com/genymobile/scrcpy/device/DesktopConnection.java`](https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/device/DesktopConnection.java) (Desktop connection), [`server/src/main/java/com/genymobile/scrcpy/Server.java`](https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/Server.java) (Server orchestrator), [`app/src/receiver.c`](https://github.com/genymobile/scrcpy/blob/master/app/src/receiver.c) (Receive and demux), [`app/src/scrcpy.c`](https://github.com/genymobile/scrcpy/blob/master/app/src/scrcpy.c) (Client runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop client"]
  node_cli["CLI options<br/>[cli.c]"]
  node_client["Client runtime<br/>[scrcpy.c]"]
end

subgraph group_connection["Device connection"]
  node_adb["ADB connection<br/>[adb.c]"]
  node_tunnel["ADB tunnels<br/>[adb_tunnel.c]"]
  node_server_launch["Server launch<br/>[server.c]"]
end

subgraph group_device["Android server"]
  node_server["Server orchestrator<br/>[Server.java]"]
  node_device_state["Device services<br/>[Device.java]"]
  node_desktop_link["Desktop connection"]
end

subgraph group_media["Media pipeline"]
  node_video_capture["Screen and camera capture"]
  node_video_encode["Video encoding"]
  node_audio_capture["Audio capture<br/>[AudioCapture.java]"]
  node_audio_encode["Audio encoding<br/>[AudioEncoder.java]"]
  node_client_receive["Receive and demux<br/>[receiver.c]"]
  node_decoder["Video decoding<br/>[decoder.c]"]
  node_screen["Display and playback<br/>[screen.c]"]
  node_record["Media recording<br/>[recorder.c]"]
  node_v4l2["V4L2 webcam sink<br/>[v4l2_sink.c]"]
  node_virtual_camera["Virtual display and camera<br/>[CameraCapture.java]"]
end

subgraph group_control["Control and extensions"]
  node_input["Input handling<br/>[input_manager.c]"]
  node_controller["Control transport<br/>[controller.c]"]
  node_device_control["Android control<br/>[Controller.java]"]
  node_input_service["Input service<br/>[InputManager.java]"]
  node_clipboard["Clipboard sync<br/>[Controller.java]"]
  node_hid_otg["HID and OTG<br/>[scrcpy_otg.c]"]
end

node_user(("Desktop user"))

node_user -->|"configures"| node_cli
node_cli -.->|"starts"| node_client
node_client -->|"connects through"| node_adb
node_adb -.->|"opens tunnels"| node_tunnel
node_client -->|"launches server"| node_server_launch
node_server_launch -->|"starts"| node_server
node_server -->|"opens connection"| node_desktop_link
node_server -.->|"configures"| node_device_state
node_server -->|"starts capture"| node_video_capture
node_server -->|"starts capture"| node_audio_capture
node_video_capture -.->|"encodes video"| node_video_encode
node_audio_capture -.->|"encodes audio"| node_audio_encode
node_video_encode -.->|"sends stream"| node_desktop_link
node_audio_encode -.->|"sends stream"| node_desktop_link
node_desktop_link -->|"transports media"| node_client_receive
node_client_receive -.->|"demuxes video"| node_decoder
node_decoder -.->|"renders frames"| node_screen
node_client_receive -.->|"records media"| node_record
node_user -->|"provides input"| node_input
node_input -.->|"uses display state"| node_screen
node_input -.->|"queues controls"| node_controller
node_controller -.->|"sends controls"| node_desktop_link
node_desktop_link -->|"carries controls"| node_device_control
node_device_control -.->|"injects events"| node_input_service
node_device_control -->|"syncs clipboard"| node_clipboard
node_user -->|"uses physical input"| node_hid_otg
node_video_capture -->|"supports sources"| node_virtual_camera
node_client_receive -->|"outputs video"| node_v4l2

click node_cli "https://github.com/genymobile/scrcpy/blob/master/app/src/cli.c"
click node_client "https://github.com/genymobile/scrcpy/blob/master/app/src/scrcpy.c"
click node_adb "https://github.com/genymobile/scrcpy/blob/master/app/src/adb/adb.c"
click node_tunnel "https://github.com/genymobile/scrcpy/blob/master/app/src/adb/adb_tunnel.c"
click node_server_launch "https://github.com/genymobile/scrcpy/blob/master/app/src/server.c"
click node_server "https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/Server.java"
click node_device_state "https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/device/Device.java"
click node_desktop_link "https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/device/DesktopConnection.java"
click node_video_capture "https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/video/SurfaceCapture.java"
click node_video_encode "https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/video/SurfaceEncoder.java"
click node_audio_capture "https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/audio/AudioCapture.java"
click node_audio_encode "https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/audio/AudioEncoder.java"
click node_client_receive "https://github.com/genymobile/scrcpy/blob/master/app/src/receiver.c"
click node_decoder "https://github.com/genymobile/scrcpy/blob/master/app/src/decoder.c"
click node_screen "https://github.com/genymobile/scrcpy/blob/master/app/src/screen.c"
click node_record "https://github.com/genymobile/scrcpy/blob/master/app/src/recorder.c"
click node_input "https://github.com/genymobile/scrcpy/blob/master/app/src/input_manager.c"
click node_controller "https://github.com/genymobile/scrcpy/blob/master/app/src/controller.c"
click node_device_control "https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/control/Controller.java"
click node_input_service "https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/wrappers/InputManager.java"
click node_clipboard "https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/control/Controller.java"
click node_hid_otg "https://github.com/genymobile/scrcpy/blob/master/app/src/usb/scrcpy_otg.c"
click node_v4l2 "https://github.com/genymobile/scrcpy/blob/master/app/src/v4l2_sink.c"
click node_virtual_camera "https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/video/CameraCapture.java"

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_cli,node_client,node_user toneBlue
class node_adb,node_tunnel,node_server_launch toneAmber
class node_server,node_device_state,node_desktop_link toneMint
class node_video_capture,node_video_encode,node_audio_capture,node_audio_encode,node_client_receive,node_decoder,node_screen,node_record,node_v4l2,node_virtual_camera toneRose
class node_input,node_controller,node_device_control,node_input_service,node_clipboard,node_hid_otg toneIndigo
```

## Components

### Desktop client

- [CLI options](https://github.com/genymobile/scrcpy/blob/master/app/src/cli.c): `app/src/cli.c`
- [Client runtime](https://github.com/genymobile/scrcpy/blob/master/app/src/scrcpy.c): `app/src/scrcpy.c`

### Device connection

- [ADB connection](https://github.com/genymobile/scrcpy/blob/master/app/src/adb/adb.c): `app/src/adb/adb.c`
- [ADB tunnels](https://github.com/genymobile/scrcpy/blob/master/app/src/adb/adb_tunnel.c): `app/src/adb/adb_tunnel.c`
- [Server launch](https://github.com/genymobile/scrcpy/blob/master/app/src/server.c): `app/src/server.c`

### Android server

- [Server orchestrator](https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/Server.java): `server/src/main/java/com/genymobile/scrcpy/Server.java`
- [Device services](https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/device/Device.java): `server/src/main/java/com/genymobile/scrcpy/device/Device.java`
- [Desktop connection](https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/device/DesktopConnection.java): `server/src/main/java/com/genymobile/scrcpy/device/DesktopConnection.java`

### Media pipeline

- [Screen and camera capture](https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/video/SurfaceCapture.java): `server/src/main/java/com/genymobile/scrcpy/video/SurfaceCapture.java`
- [Video encoding](https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/video/SurfaceEncoder.java): `server/src/main/java/com/genymobile/scrcpy/video/SurfaceEncoder.java`
- [Audio capture](https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/audio/AudioCapture.java): `server/src/main/java/com/genymobile/scrcpy/audio/AudioCapture.java`
- [Audio encoding](https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/audio/AudioEncoder.java): `server/src/main/java/com/genymobile/scrcpy/audio/AudioEncoder.java`
- [Receive and demux](https://github.com/genymobile/scrcpy/blob/master/app/src/receiver.c): `app/src/receiver.c`
- [Video decoding](https://github.com/genymobile/scrcpy/blob/master/app/src/decoder.c): `app/src/decoder.c`
- [Display and playback](https://github.com/genymobile/scrcpy/blob/master/app/src/screen.c): `app/src/screen.c`
- [Media recording](https://github.com/genymobile/scrcpy/blob/master/app/src/recorder.c): `app/src/recorder.c`
- [V4L2 webcam sink](https://github.com/genymobile/scrcpy/blob/master/app/src/v4l2_sink.c): `app/src/v4l2_sink.c`
- [Virtual display and camera](https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/video/CameraCapture.java): `server/src/main/java/com/genymobile/scrcpy/video/CameraCapture.java`

### Control and extensions

- [Input handling](https://github.com/genymobile/scrcpy/blob/master/app/src/input_manager.c): `app/src/input_manager.c`
- [Control transport](https://github.com/genymobile/scrcpy/blob/master/app/src/controller.c): `app/src/controller.c`
- [Android control](https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/control/Controller.java): `server/src/main/java/com/genymobile/scrcpy/control/Controller.java`
- [Input service](https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/wrappers/InputManager.java): `server/src/main/java/com/genymobile/scrcpy/wrappers/InputManager.java`
- [Clipboard sync](https://github.com/genymobile/scrcpy/blob/master/server/src/main/java/com/genymobile/scrcpy/control/Controller.java): `server/src/main/java/com/genymobile/scrcpy/control/Controller.java`
- [HID and OTG](https://github.com/genymobile/scrcpy/blob/master/app/src/usb/scrcpy_otg.c): `app/src/usb/scrcpy_otg.c`

### Other components

- **Desktop user**

## Connections

- Desktop user → CLI options: configures
- CLI options → Client runtime: starts
- Client runtime → ADB connection: connects through
- ADB connection → ADB tunnels: opens tunnels
- Client runtime → Server launch: launches server
- Server launch → Server orchestrator: starts (evidence: `app/src/server.c`)
- Server orchestrator → Desktop connection: opens connection (evidence: `server/src/main/java/com/genymobile/scrcpy/Server.java`)
- Server orchestrator → Device services: configures (evidence: `server/src/main/java/com/genymobile/scrcpy/Server.java`)
- Server orchestrator → Screen and camera capture: starts capture (evidence: `server/src/main/java/com/genymobile/scrcpy/Server.java`)
- Server orchestrator → Audio capture: starts capture (evidence: `server/src/main/java/com/genymobile/scrcpy/Server.java`)
- Screen and camera capture → Video encoding: encodes video
- Audio capture → Audio encoding: encodes audio
- Video encoding → Desktop connection: sends stream
- Audio encoding → Desktop connection: sends stream
- Desktop connection → Receive and demux: transports media
- Receive and demux → Video decoding: demuxes video
- Video decoding → Display and playback: renders frames
- Receive and demux → Media recording: records media
- Desktop user → Input handling: provides input
- Input handling → Display and playback: uses display state
- Input handling → Control transport: queues controls
- Control transport → Desktop connection: sends controls
- Desktop connection → Android control: carries controls
- Android control → Input service: injects events (evidence: `server/src/main/java/com/genymobile/scrcpy/control/Controller.java`)
- Android control → Clipboard sync: syncs clipboard (evidence: `server/src/main/java/com/genymobile/scrcpy/control/Controller.java`)
- Desktop user → HID and OTG: uses physical input
- Screen and camera capture → Virtual display and camera: supports sources (evidence: `server/src/main/java/com/genymobile/scrcpy/video/CameraCapture.java`)
- Receive and demux → V4L2 webcam sink: outputs video
