Skip to content

scrcpy v1.15

Compare
Choose a tag to compare
@rom1v rom1v released this 06 Aug 19:54
· 1820 commits to master since this release
v1.15

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


scrcpy v1.15

Changes since v1.14:

  • Forward Ctrl and Shift to the device (#1598, #555, #942)
  • Change "resize to fit" shortcut from MOD+x to MOD+w (#1598)
  • Make shortcut modifiers customizable (#1598)
  • Restore power mode to "normal" on disconnection (#1572, #1576)
  • Keep the screen off on powering on (best effort) (#1573, #1577)
  • Add option to disable screensaver (#1370, #1502)
  • Do not crash on missing clipboard manager (#1440, #1556)
  • Fix touch events HiDPI-scaling (#1536, #15)
  • Correctly inject repeating keycodes (#1013, #1519)
  • Add option to ignore repeated key events (#1013, #1623)
  • Increase clipboard size from 4k to 256k (#1117)
  • Do not expose internal SDL logs to users (#1441)
  • Upgrade platform-tools to 30.0.4 (adb) in Windows releases
  • Upgrade FFmpeg to 4.3.1 in Windows releases

Highlights

Ctrl and Shift

Ctrl and Shift keys are now forwarded to the device.

This allows to trigger many shortcuts on the device itself. For example, Ctrl+t in Firefox opens a new tab, Ctrl+w closes the current tab. Ctrl+c or Ctrl+d can now be injected in Termux. Ctrl+z could be used to cancel an action, like a change in a text field for example.

This also greatly simplifies text selection, by using the keyboard (Shift+arrows, Ctrl+a…). And it makes copy-paste more straightforward (see below).

Customizable shortcut modifier

Since Ctrl is now forwarded to the device, scrcpy must use another shortcut modifier (called MOD in the documentation). By default, it's either (left) Alt or (left) Super.

The shortcut modifier can be changed by a command-line parameter (--shortcut-mod). Here are some examples:

# use RCtrl for shortcuts
scrcpy --shortcut-mod=rctrl
# use either LAlt or RCtrl
scrcpy --shortcut-mod=lalt,rctrl
# use LCtrl+LAlt
scrcpy --shortcut-mod=lctrl+lalt
# use LCtrl+LAlt or Super
scrcpy --shortcut-mod=lctrl+lalt,lsuper,rsuper

Seamless copy-paste

Forwarding Ctrl brings a lot of changes and improvements regarding copy-paste:

  • To copy or cut a text, Ctrl+c and Ctrl+x typically work, because they are forwarded to the device, which, in a text field, copies the text into the clipboard… and the clipboard is now automatically (since v1.14) synchronized with the computer keyboard.
  • Pressing Ctrl+v synchronizes the computer clipboard to the device before sending the key event, therefore pasting typically works seamlessly.
  • Seamless copy-paste introduced in v1.14 was limited if Android <= 7; by using Ctrl keys, it now works on all supported versions.
  • MOD+c, MOD+x and MOD+v are also provided to inject COPY, CUT and PASTE keycodes (see README for details).
  • MOD+Shift+v injects the computer clipboard content as a sequence of key events (it was Ctrl+v on previous versions, this is still useful sometimes).
  • to be able to bind CUT to MOD+x, the "resize to fit" shortcut (which removes the black borders) has been changed to MOD+w.

The clipboard size has also been increased from 4k to 256k.

Screen off improvements

MOD+o (or --turn-screen-off) allows to mirror with physical screen turned off.

However, the physical screen was not automatically restored on disconnection, which was annoying. Now it is.

In addition, on Android, pressing POWER cancels the effect of turn screen off. For convenience, scrcpy now attempts to maintain the screen off when it generates a POWER event (either via right-click or MOD+p).

Repeating key events

When a key is hold pressed, the system generates repeated key events.

The repeat count is now correctly forwarded to Android, and an option (--no-key-repeat) has been added to completely disable them. This mitigates keyboard lag in some games.