scrcpy/doc/video.md

6.2 KiB
Raw Permalink Blame History

Video

Source

By default, scrcpy mirrors the device screen.

It is possible to capture the device camera instead.

See the dedicated camera page.

Size

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 version

The 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).

Bit rate

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 version

Frame rate

The capture frame rate can be limited:

scrcpy --max-fps=15

The 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.

Codec

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=av1

H265 may provide better quality, but H264 should provide lower latency. AV1 encoders are not common on current Android devices.

For advanced usage, to pass arbitrary parameters to the MediaFormat, check --video-codec-options in the manpage or in scrcpy --help.

Encoder

Several encoders may be available on the device. They can be listed by:

scrcpy --list-encoders

Sometimes, 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'

Orientation

The orientation 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-orientation changes the mirroring orientation (the orientation of the video sent from the device to the computer). This affects the recording.
  • --orientation is applied on the client side, and affects display and recording. For the display, it can be changed dynamically using shortcuts.

To lock the mirroring orientation (on the capture side):

scrcpy --lock-video-orientation      # initial (current) orientation
scrcpy --lock-video-orientation=0    # natural orientation
scrcpy --lock-video-orientation=90   # 90° clockwise
scrcpy --lock-video-orientation=180  # 180°
scrcpy --lock-video-orientation=270  # 270° clockwise

To orient the video (on the rendering side):

scrcpy --orientation=0
scrcpy --orientation=90       # 90° clockwise
scrcpy --orientation=180      # 180°
scrcpy --orientation=270      # 270° clockwise
scrcpy --orientation=flip0    # hflip
scrcpy --orientation=flip90   # hflip + 90° clockwise
scrcpy --orientation=flip180  # vflip (hflip + 180°)
scrcpy --orientation=flip270  # hflip + 270° clockwise

The orientation can be set separately for display and record if necessary, via --display-orientation and --record-orientation.

The rotation is applied to a recorded file by writing a display transformation to the MP4 or MKV target file. Flipping is not supported, so only the 4 first values are allowed when recording.

Crop

The 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.

Display

If several displays are available on the Android device, it is possible to select the display to mirror:

scrcpy --display-id=1

The list of display ids can be retrieved by:

scrcpy --list-displays

A secondary display may only be controlled if the device runs at least Android 10 (otherwise it is mirrored as read-only).

Buffering

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 playback

They can be applied simultaneously:

scrcpy --display-buffer=50 --v4l2-buffer=300

No playback

It is possible to capture an Android device without playing video or audio on the computer. This option is useful when recording or when v4l2 is enabled:

scrcpy --v4l2-sink=/dev/video2 --no-playback
scrcpy --record=file.mkv --no-playback
# interrupt with Ctrl+C

It is also possible to disable video and audio playback separately:

# Send video to V4L2 sink without playing it, but keep audio playback
scrcpy --v4l2-sink=/dev/video2 --no-video-playback

# Record both video and audio, but only play video
scrcpy --record=file.mkv --no-audio-playback

No video

To disable video forwarding completely, so that only audio is forwarded:

scrcpy --no-video

Video4Linux

See the dedicated Video4Linux page.