v1.20

_To receive a notification on new releases, click on **Watch > Releases only** on the top._

---

**scrcpy v1.20**

Changes since v1.19:
 - Add official high-resolution icon (#1497, #1987)
 - Add HID keyboard support on Linux (#2632)
 - Adapt --help output to terminal size
 - Rework server initialization to avoid unresponsive Ctrl+c sometimes
 - Remove deprecated short options -T and -c
 - Fix "Could not find v4l2 muxer" (#2718)
 - Fix workarounds for Meizu devices (#240, #2656)
 - Fix support for expand notification feature on some devices (#2551)
 - Various technical refactors and fixes

---

# Highlights

## New scrcpy icon

Scrcpy used a low-definition XPM icon. Its [source code][xpm_icon] was [cool][xpm_icon_blog], but the [result][#1497] was awful.

[xpm_icon]: https://github.com/Genymobile/scrcpy/blob/v1.0/app/src/icon.xpm
[xpm_icon_blog]: https://blog.rom1v.com/2018/03/introducing-scrcpy/#set-a-window-icon
[#1497]: https://github.com/Genymobile/scrcpy/issues/1497

This version introduces a new official icon (designed by @varlesh, author of the [papirus icon theme][papirus]):

<img src="https://github.com/Genymobile/scrcpy/blob/v1.20/data/icon.svg" width="256" height="256" alt="scrcpy" />

[papirus]: https://github.com/PapirusDevelopmentTeam/papirus-icon-theme


## HID keyboard

By default, scrcpy uses Android key or text injection: it works everywhere, but is (basically) limited to ASCII characters.

It is now possible to simulate a [physical USB keyboard] (#2632 by @AlynxZhou): the virtual keyboard is disabled and it works for all characters and IME.

[USB-HID]: https://github.com/Genymobile/scrcpy#physical-keyboard-simulation-hid

However, it only works if the device is connected by USB, and is currently only supported on Linux _(you could help making it work on [Windows][#2773] and [macOS][#2774])_.

[physical USB keyboard]: https://github.com/Genymobile/scrcpy/tree/v1.20#physical-keyboard-simulation-hid
[#2773]: https://github.com/Genymobile/scrcpy/issues/2773
[#2774]: https://github.com/Genymobile/scrcpy/issues/2774

To enable this mode:

```bash
scrcpy --hid-keyboard
scrcpy -K  # short version
```

If it fails for some reason (for example because the device is not connected via USB), it automatically fallbacks to the default mode (with a log in the console). This allows to use the same command line options when connected over USB and TCP/IP.

In this mode, raw key events (scancodes) are sent to the device, independently of the host key mapping. Therefore, if your keyboard layout does not match, it must be configured on the Android device, in Settings → System → Languages and input → [Physical keyboard].

[Physical keyboard]: https://github.com/Genymobile/scrcpy/pull/2632#issuecomment-923756915


## Remove deprecated short options

Some command line options were first introduced with a short version:
 - `-c`/`--crop`
 - `-T`/`--always-on-top`

Since these are "advanced" features (not common enough), the short version of these options had been deprecated in scrcpy v1.11 two years ago. It's time to remove them (and it simplified some refactors). Only the long version remains.