How genymobile/scrcpy works
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: DesktopConnection.java Desktop connection · Server.java Server orchestrator · receiver.c Receive and demux · scrcpy.c Client runtime
Components 25
Desktop client
- CLI options
app/src/cli.c - Client runtime
app/src/scrcpy.c
Device connection
- ADB connection
app/src/adb/adb.c - ADB tunnels
app/src/adb/adb_tunnel.c - Server launch
app/src/server.c
Android server
- Server orchestrator
server/src/main/java/com/genymobile/scrcpy/Server.java - Device services
server/src/main/java/com/genymobile/scrcpy/device/Device.java - Desktop connection
server/src/main/java/com/genymobile/scrcpy/device/DesktopConnection.java
Media pipeline
- Screen and camera capture
server/src/main/java/com/genymobile/scrcpy/video/SurfaceCapture.java - Video encoding
server/src/main/java/com/genymobile/scrcpy/video/SurfaceEncoder.java - Audio capture
server/src/main/java/com/genymobile/scrcpy/audio/AudioCapture.java - Audio encoding
server/src/main/java/com/genymobile/scrcpy/audio/AudioEncoder.java - Receive and demux
app/src/receiver.c - Video decoding
app/src/decoder.c - Display and playback
app/src/screen.c - Media recording
app/src/recorder.c - V4L2 webcam sink
app/src/v4l2_sink.c - Virtual display and camera
server/src/main/java/com/genymobile/scrcpy/video/CameraCapture.java
Control and extensions
- Input handling
app/src/input_manager.c - Control transport
app/src/controller.c - Android control
server/src/main/java/com/genymobile/scrcpy/control/Controller.java - Input service
server/src/main/java/com/genymobile/scrcpy/wrappers/InputManager.java - Clipboard sync
server/src/main/java/com/genymobile/scrcpy/control/Controller.java - HID and OTG
app/src/usb/scrcpy_otg.c
Other components
- Desktop user
Connections 28
- 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
app/src/server.c - Server orchestrator → Desktop connection: opens connection
server/src/main/java/com/genymobile/scrcpy/Server.java - Server orchestrator → Device services: configures
server/src/main/java/com/genymobile/scrcpy/Server.java - Server orchestrator → Screen and camera capture: starts capture
server/src/main/java/com/genymobile/scrcpy/Server.java - Server orchestrator → Audio capture: starts capture
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
server/src/main/java/com/genymobile/scrcpy/control/Controller.java - Android control → Clipboard sync: syncs clipboard
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
server/src/main/java/com/genymobile/scrcpy/video/CameraCapture.java - Receive and demux → V4L2 webcam sink: outputs video