scrcpy 命令

常用示例

说明

scrcpy (screen copy) displays and controls Android devices from desktop. It mirrors the device screen with low latency, enabling interaction via mouse and keyboard. Connection works over USB or WiFi. USB provides best performance; WiFi enables untethered use. The tool uses ADB for communication and custom server pushed to the device. Control includes touch emulation, keyboard input, clipboard sync, and device buttons (power, volume, back). Multi-touch is supported with mouse + keyboard modifiers. Recording captures the mirrored screen to MP4 or MKV without audio overhead. Combined with --no-display, it enables headless recording. Screen-off mode keeps the device screen off while displaying on desktop - useful for battery saving. Stay-awake prevents device sleep during mirroring. Window management options control placement and behavior. Fullscreen and always-on-top modes optimize different workflows.

参数

-s _SERIAL_, --serial _SERIAL_

Device serial number.

--max-size, -m _SIZE_

Limit resolution (shorter edge).

--max-fps _FPS_

Limit frame rate.

-r, --record _FILE_

Record to file (mp4/mkv).

-b _RATE_, --video-bit-rate _RATE_

Video bitrate (default: 8M). Older versions use --bit-rate.

-n, --no-control

Disable control (mirror only).

-N, --no-playback

Disable playback on computer (useful for headless recording). Previously --no-display.

--show-touches

Show physical touches on the device.

-S, --turn-screen-off

Turn device screen off while mirroring.

-w, --stay-awake

Keep device awake while plugged in.

--window-title _TITLE_

Custom window title.

--window-x _X_

Window X position.

--window-y _Y_

Window Y position.

--window-width _W_

Window width.

--window-height _H_

Window height.

--fullscreen, -f

Start fullscreen.

--always-on-top

Keep window on top.

--crop _W:H:X:Y_

Crop screen region.

--no-audio

Disable audio forwarding.