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

scrcpy v1.17

Changes since v1.16:

• Fix errors on Android 11 (#1468)
• Add --encoder option (#1810, #1827)
• Add --forward-all-clicks option (#1302, #1613)
• Add --legacy-paste option (#1750, #1771)
• Workaround screen off/on issue on exit (#1670)
• Rework console/noconsole versions on Windows (#1875, #1988)
• Terminate server properly without killing it on close (#1992)
• List available shortcut keys on error (#1681)
• Upgrade platform-tools to 30.0.5 (adb) in Windows releases
• Upgrade SDL to 2.0.14 in Windows releases

Highlights

Android 11

The options --show-touches and --stay-awake have been broken by internal API changes in Android 11. The implementation have been adapted to work properly.

Forward right-click and middle-click

By default, scrcpy injects BACK on right-click and HOME on middle-click.

A new option --forward-all-clicks has been added to forward these clicks to the device instead.

Copy-paste workaround

Copy-paste have been improved by previous releases, especially v1.15.

However, setting the device clipboard programmatically does not work properly on some devices, causing confusing behavior (injecting PASTE does not paste the content set programmatically).

As a workaround, an option --legacy-paste is provided to change the behavior of Ctrl+v and MOD+v so that they also inject the computer clipboard text as a sequence of key events (the same way as MOD+Shift+v).

Screen off workarounds

Scrcpy v1.15 added restoration of the power mode on exit, to avoid leaving the physical screen off (enabled by --turn-screen-off or MOD+o).

However, restoring the power mode while the device screen was off caused unexpected behaviors (even if the "screen off" feature was not used). Therefore, if the screen was off, don't try to restore the power mode, the state is already as expected.

Encoder selection

Some devices provide several encoders, and some of them may not work well.

A new option --encoder allows to select another available H.264 encoder.

Windows console/noconsole

Scrcpy is a command-line tool, so it does not suit Windows very well.

By default, running scrcpy.exe opens a new console, which is closed as soon as the process terminates. To let the user a chance to read any error message, a "pause" was implemented on error, but this caused issues for scripting (#1875).

In addition, to avoid opening a new terminal, a separate binary was provided with a special linking flag.

To simplify, these hacks have been moved into Windows-specific wrapper scripts:

• scrcpy.exe is the main binary, with the same behavior as on other platforms (no pause on error)
• scrcpy-console.bat is a simple wrapper script to pause on error
• scrcpy-noconsole.vbs a one-line VBS script to start scrcpy.exe without a console