Camera
Camera mirroring is supported for devices with Android 12 or higher.
To capture the camera instead of the device screen:
scrcpy --video-source=cameraBy default, it automatically switches audio source to
microphone (as if --audio-source=mic were also passed).
scrcpy --video-source=display # default is --audio-source=outputscrcpy --video-source=camera # default is --audio-source=micscrcpy --video-source=display --audio-source=mic # force display AND microphonescrcpy --video-source=camera --audio-source=output # force camera AND device audio outputAudio can be disabled:
# audio not captured at allscrcpy --video-source=camera --no-audioscrcpy --video-source=camera --no-audio --record=file.mp4
# audio captured and recorded, but not playedscrcpy --video-source=camera --no-audio-playback --record=file.mp4To list the cameras available (with their declared valid sizes and frame rates):
scrcpy --list-camerasscrcpy --list-camera-sizesNote that the sizes and frame rates are declarative. They are not accurate on all devices: some of them are declared but not supported, while some others are not declared but supported.
Selection
Section titled “Selection”It is possible to pass an explicit camera id (as listed by --list-cameras):
scrcpy --video-source=camera --camera-id=0Alternatively, the camera may be selected automatically:
scrcpy --video-source=camera # use the first camerascrcpy --video-source=camera --camera-facing=front # use the first front camerascrcpy --video-source=camera --camera-facing=back # use the first back camerascrcpy --video-source=camera --camera-facing=external # use the first external cameraIf --camera-id is specified, then --camera-facing is forbidden (the id
already determines the camera):
scrcpy --video-source=camera --camera-id=0 --camera-facing=front # errorSize selection
Section titled “Size selection”It is possible to pass an explicit camera size:
scrcpy --video-source=camera --camera-size=1920x1080The given size may be listed among the declared valid sizes
(--list-camera-sizes), but may also be anything else (some devices support
arbitrary sizes):
scrcpy --video-source=camera --camera-size=1840x444Alternatively, a declared valid size (among the ones listed by
list-camera-sizes) may be selected automatically.
Two constraints are supported:
-m/--max-size(already used for display mirroring), for example-m1920;--camera-arto specify an aspect ratio (<num>:<den>,<value>orsensor).
Some examples:
scrcpy --video-source=camera # use the greatest width and the greatest associated heightscrcpy --video-source=camera -m1920 # use the greatest width not above 1920 and the greatest associated heightscrcpy --video-source=camera --camera-ar=4:3 # use the greatest size with an aspect ratio of 4:3 (+/- 10%)scrcpy --video-source=camera --camera-ar=1.6 # use the greatest size with an aspect ratio of 1.6 (+/- 10%)scrcpy --video-source=camera --camera-ar=sensor # use the greatest size with the aspect ratio of the camera sensor (+/- 10%)scrcpy --video-source=camera -m1920 --camera-ar=16:9 # use the greatest width not above 1920 and the closest to 16:9 aspect ratioIf --camera-size is specified, then -m/--max-size and --camera-ar are
forbidden (the size is determined by the value given explicitly):
scrcpy --video-source=camera --camera-size=1920x1080 -m3000 # errorRotation
Section titled “Rotation”To rotate the captured video, use the video orientation option:
scrcpy --video-source=camera --camera-size=1920x1080 --orientation=90Frame rate
Section titled “Frame rate”By default, camera is captured at Android’s default frame rate (30 fps).
To configure a different frame rate:
scrcpy --video-source=camera --camera-fps=60High speed capture
Section titled “High speed capture”The Android camera API also supports a high speed capture mode.
This mode is restricted to specific resolutions and frame rates, listed by
--list-camera-sizes.
scrcpy --video-source=camera --camera-size=1920x1080 --camera-fps=240Brace expansion tip
Section titled “Brace expansion tip”All camera options start with --camera-, so if your shell supports it, you can
benefit from brace expansion (for example, it is supported bash and zsh):
scrcpy --video-source=camera --camera-{facing=back,ar=16:9,high-speed,fps=120}This will be expanded as:
scrcpy --video-source=camera --camera-facing=back --camera-ar=16:9 --camera-high-speed --camera-fps=120Webcam
Section titled “Webcam”Combined with the V4L2 feature on Linux, the Android device camera may be used as a webcam on the computer.