By default, scrcpy attempts to mirror at the Android device resolution.
It might be useful to mirror at a lower definition to increase performance. To limit both width and height to some maximum value (here 1024):
scrcpy --max-size=1024
scrcpy -m 1024 # short versionThe other dimension is computed so that the Android device aspect ratio is preserved. That way, a device in 1920×1080 will be mirrored at 1024×576.
If encoding fails, scrcpy automatically tries again with a lower definition
(unless --no-downsize-on-error is enabled).
The default video bit rate is 8 Mbps. To change it:
scrcpy --video-bit-rate=2M
scrcpy --video-bit-rate=2000000 # equivalent
scrcpy -b 2M # short versionThe capture frame rate can be limited:
scrcpy --max-fps=15The actual capture frame rate may be printed to the console:
scrcpy --print-fps
It may also be enabled or disabled at anytime with MOD+i (see shortcuts).
The frame rate is intrinsically variable: a new frame is produced only when the screen content changes. For example, if you play a fullscreen video at 24fps on your device, you should not get more than 24 frames per second in scrcpy.
The video codec can be selected. The possible values are h264 (default),
h265 and av1:
scrcpy --video-codec=h264 # default
scrcpy --video-codec=h265
scrcpy --video-codec=av1H265 may provide better quality, but H264 should provide lower latency. AV1 encoders are not common on current Android devices.
Several encoders may be available on the device. They can be listed by:
scrcpy --list-encodersSometimes, the default encoder may have issues or even crash, so it is useful to try another one:
scrcpy --video-codec=h264 --video-encoder='OMX.qcom.video.encoder.avc'For advanced usage, to pass arbitrary parameters to the MediaFormat,
check --video-codec-options in the manpage or in scrcpy --help.
The rotation may be applied at 3 different levels:
- The shortcut MOD+r requests the device to switch between portrait and landscape (the current running app may refuse, if it does not support the requested orientation).
--lock-video-orientationchanges the mirroring orientation (the orientation of the video sent from the device to the computer). This affects the recording.--rotationrotates only the window content. This only affects the display, not the recording. It may be changed dynamically at any time using the shortcuts MOD+← and MOD+→.
To lock the mirroring orientation:
scrcpy --lock-video-orientation # initial (current) orientation
scrcpy --lock-video-orientation=0 # natural orientation
scrcpy --lock-video-orientation=1 # 90° counterclockwise
scrcpy --lock-video-orientation=2 # 180°
scrcpy --lock-video-orientation=3 # 90° clockwiseTo set an initial window rotation:
scrcpy --rotation=0 # no rotation
scrcpy --rotation=1 # 90 degrees counterclockwise
scrcpy --rotation=2 # 180 degrees
scrcpy --rotation=3 # 90 degrees clockwiseThe device screen may be cropped to mirror only part of the screen.
This is useful, for example, to mirror only one eye of the Oculus Go:
scrcpy --crop=1224:1440:0:0 # 1224x1440 at offset (0,0)The values are expressed in the device natural orientation (portrait for a phone, landscape for a tablet).
If --max-size is also specified, resizing is applied after cropping.
By default, there is no video buffering, to get the lowest possible latency.
Buffering can be added to delay the video stream and compensate for jitter to get a smoother playback (see #2464).
The configuration is available independently for the display, v4l2 sinks and audio playback.
scrcpy --display-buffer=50 # add 50ms buffering for display
scrcpy --v4l2-buffer=300 # add 300ms buffering for v4l2 sink
scrcpy --audio-buffer=200 # set 200ms buffering for audio playbackThey can be applied simultaneously:
scrcpy --display-buffer=50 --v4l2-buffer=300It is possible to capture an Android device without displaying a mirroring window. This option is available if either recording or v4l2 is enabled:
scrcpy --v4l2-sink=/dev/video2 --no-display
scrcpy --record=file.mkv --no-displaySee the dedicated Video4Linux page.