v4.1
scrcpy 4.1
View on GitHubView PackagePublished: Jul 12, 2026

Release Notes

To receive a notification when a new release is available, click on Watch > Custom > Releases at the top.


scrcpy v4.1

Changes since v4.0:

  • Add support for VP8 and VP9 video encoders (#6763, #6769)
  • Update terminal title while scrcpy is running (#6825)
  • Trigger media scan after file push (#6200, #6852)
  • Add Keywords to desktop entries (#6889)
  • Adapt the camera target size to avoid configuration error (#6919, #6922)
  • Improve the size constraints algorithm (#6829, #6859)
  • Apply encoder size constraints only after the first failure (#6848, #6859)
  • Add --ignore-video-encoder-constraints (#6904)
  • Fix some colorspace conversions (#6830, #6924)
  • Fix initial gamepad detection (#6843, #6853)
  • Fix data race possibly causing a division-by-zero error (#6905, #6911)
  • Upgrade FFmpeg to 8.1.2
  • Upgrade SDL to 3.4.12
  • Upgrade libusb to 1.0.30
  • Various technical fixes

Highlights

Size constraints

The flex display feature introduced in scrcpy 4.0 requires respecting the video encoder constraints. This caused several regressions:

  • sometimes, the reported encoder constraints are incorrect;
  • they were not handled correctly for camera capture;
  • the algorithm used to determine the maximum supported size for a given aspect ratio was too naive.

To fix or work around these issues:

  • encoder size constraints are now initially ignored and enforced only after the first capture failure;
  • the size constraints algorithm has been improved to select the best supported size for a given aspect ratio;
  • a new option, --ignore-video-encoder-constraints, has been added to ignore the encoder constraints entirely, including alignment (useful when the reported values are incorrect).

Terminal title

The terminal title is now updated while scrcpy is running. See #6825.

VP8 and VP9

Some devices do not support H.264, H.265, or AV1 encoding, but do support VP8 or VP9.

This release adds support for VP8 and VP9 (if supported by the device):

scrcpy --video-codec=vp9

Media scan

When pushing files via drag&drop, some Android apps do not detect the new files immediately. This release now triggers a media scan request to increase the chances that the new files are detected immediately.