Scrcpy v1.9 (screen-mirroring app) released

scrcpy v1.9

Changes since v1.8:

  • Add feature to turn screen off while mirroring (#175)
  • Add device-to-computer clipboard copy (#145)
  • Add computer-to-device clipboard copy (#413)
  • Find scrcpy-server.jar in the correct directory on Windows
  • Fix mouse focus clickthrough
  • Do not minimize the window on focus loss (#554)
  • Disable X11 compositor bypass (#522)
  • Continue text injection on failed character (#509)
  • Bind Home key to MOVE_HOME instead of HOME screen (#555)
  • Do not crash if expanding/collapsing panels is not supported (#506)
  • Do not power on the device if –no-control is set
  • Improve framerate counting
  • Add runtime option to render expired frames (i.e. not skip frames)
  • Downgrade SDL to 2.0.8 in Windows releases (#425)
  • Upgrade FFmpeg to 4.1.3 in Windows releases
  • Upgrade platform-tools to 29.0.1 (adb) in Windows releases


Here are some highlights of the changes introduced by scrcpy 1.9.

Turn device screen off

Many users requested to turn the device screen off while mirroring (#145).

It is now possible at any time, by pressing Ctrl+o. To turn it back on, just use the POWER button (or Ctrl+p), once to switch off the (mirrored) device, once again to turn both the physical and mirroring on.

To turn the device screen off on start:

scrcpy --turn-screen-off
scrcpy -S

Copy-paste in both directions

It was already possible to copy-paste from the computer to the Android device (Ctrl+v), by injecting the text character by character (with all the limitations of text injection).

Now, it is also possible to copy the Android device clipboard (Ctrl+c) to paste it on the computer.

In addition, Ctrl+Shift+v allow to copy the computer clipboard to the device, but without pasting it, so that it can then be pasted manually on Android. That way, the clipboard content is not broken by text injection, so it can be used to transmit any text with special characters (an UTF-8 stream).

Windows PATH simplification

On all platforms except Windows, the absolute path of scrcpy-server.jar is hardcoded (typically to /usr/share/scrcpy/scrcpy-server.jar), so it is straightforward to know its path.

On Windows however, the server path may not be constant, so the build is “portable”: scrcpy-server.jar is expected to be in the same directory as scrcpy.exe. Concretely, to push the server to the device, scrcpy just executed:

adb push scrcpy-server.jar /data/local/tmp/

The problem is that scrcpy-server.jar is searched in the current directory, which is not necessarily the same as the scrcpy directory. Typically, if you added the scrcpy directory in your PATH to call scrcpy from anywhere, the current directory could be anything. This was very annoying and confusing (you had to set the environment variable SCRCPY_SERVER_PATH as a workaround).

Now, on Windows, the server path will be built based on the scrcpy executable path, so it works out-of-the-box.

Mouse focus clickthrough

When scrcpy doesn’t have focus, it needed one click to get focus, and another click to actually “click” on the device.

Mouse focus clickthrough was enabled in earlier versions, but a stupid regression broke it in v1.8. It has been fixed.

Products You May Like

Leave a Reply

Your email address will not be published. Required fields are marked *