scrcpy/doc/recording.md
Romain Vimont d3c2955fb9 Add --time-limit
Add an option to stop scrcpy automatically after a given delay.

PR #4052 <https://github.com/Genymobile/scrcpy/pull/4052>
Fixes #3752 <https://github.com/Genymobile/scrcpy/issues/3752>
2023-06-10 16:04:51 +02:00

1.7 KiB

Recording

To record video and audio streams while mirroring:

scrcpy --record=file.mp4
scrcpy -r file.mkv

To record only the video:

scrcpy --no-audio --record=file.mp4

To record only the audio:

scrcpy --no-video --record=file.opus
scrcpy --no-video --audio-codec=aac --record=file.aac
# .m4a/.mp4 and .mka/.mkv are also supported for both opus and aac

Timestamps are captured on the device, so packet delay variation does not impact the recorded file, which is always clean (only if you use --record of course, not if you capture your scrcpy window and audio output on the computer).

Format

The video and audio streams are encoded on the device, but are muxed on the client side. Two formats (containers) are supported:

  • Matroska (.mkv)
  • MP4 (.mp4)

The container is automatically selected based on the filename.

It is also possible to explicitly select a container (in that case the filename needs not end with .mkv or .mp4):

scrcpy --record=file --record-format=mkv

No playback

To disable playback while recording:

scrcpy --no-playback --record=file.mp4
scrcpy -Nr file.mkv
# interrupt recording with Ctrl+C

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

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

Time limit

To limit the recording time:

scrcpy --record=file.mkv --time-limit=20  # in seconds

The --time-limit option is not limited to recording, it also impacts simple mirroring:

scrcpy --time-limit=20