Skip to content

scrcpy v2.4

Latest
Latest
Compare
Choose a tag to compare
@rom1v rom1v released this 02 Mar 23:17
· 5 commits to master since this release
v2.4
This tag was signed with the committer’s verified signature. The key has expired.
rom1v Romain Vimont
GPG key ID: CA01F46F18683B3D
Expired
Learn about vigilant mode.
af57309

To receive a notification on new releases, click on Watch > Custom > Releases at the top.

scrcpy v2.4

Changes since v2.3.1:

  • Add UHID keyboard and mouse support (#4473)
  • Simulate tilt multitouch by pressing Shift (#4529)
  • Add rotation support for non-default display (#4698)
  • Improve audio player (#4572)
  • Adapt to display API changes in Android 15 (#4646, #4656, #4657)
  • Adapt audio workarounds to Android 14 (#4492)
  • Fix clipboard for IQOO devices on Android 14 (#4492, #4589, #4703)
  • Fix integer overflow for audio packet duration (#4536)
  • Rework cleanup (#4649)
  • Upgrade FFmpeg to 6.1.1 in Windows releases (#4713)
  • Upgrade libusb to 1.0.27 in Windows releases (#4713)
  • Various technical fixes

Highlights

UHID keyboard

This is a huge improvement for typing text, especially in non-English languages:

scrcpy --keyboard=uhid
scrcpy -K  # short version

It simulates a physical keyboard. Contrary to the default text injection method, it is not limited to ASCII and some other characters.

This is functionally equivalent to the existing AOA mode (--keyboard=aoa), except it is not limited to USB (it also works wirelessly) and it works on Windows while mirroring (and without driver issues).

The keyboard layout must be configured (once and for all) on the device to match that of the computer (that's the reason why it's not the default). To open the keyboard settings, several possibilities:

  • from the scrcpy window (when uhid or aoa is used), by pressing MOD+k (see shortcuts)
  • from the device, in Settings → System → Languages and input → Physical devices
  • from a terminal on the computer, by executing adb shell am start -a android.settings.HARD_KEYBOARD_SETTINGS

From there, it is also possible to enable or disable the virtual keyboard.

See #4473.

UHID mouse

Similarly, it is possible to simulate a physical mouse:

scrcpy --mouse=uhid
scrcpy -M  # short version

Like in AOA mode (--mouse=aoa), the computer mouse is "captured": the mouse pointer disappears from the computer and appears on the Android device instead.

Special capture keys, either Alt or Super, toggle (disable or enable) the mouse capture. Use one of them to give the control of the mouse back to the computer.

See #4473.

Simulate tilt

It was already possible to simulate two symmetric fingers to pinch-to-zoom or rotate by using Ctrl+click-and-move:

ctrl.mp4

This new version introduces a variant to tilt by using Shift+click-and-move-up-or-down:

shift.mp4

Technically, scrcpy generates additional touch events from a "virtual finger" at a location inverted through the center of the screen. When pressing Ctrl the x and y coordinates are inverted. Using Shift only inverts x.

See #4529 and documentation.

Android 15

A lot of refactors related to display occurred in Android, which required changes to continue working with the latest Android beta versions.

See #4657.

Assets 7