その他のミラーリング・オプション

読み取り専用

コントロールを無効にするには(デバイスと対話できるすべてのもの:入力キー、 マウスイベント、ファイルのドラッグアンドドロップ):

scrcpy --no-control
scrcpy -n

陳列

複数のディスプレイが使用可能な場合は、ディスプレイを選択して 鏡：

scrcpy --display=1

表示 ID のリストは、次の方法で取得できます。

adb shell dumpsys display   # search "mDisplayId=" in the output

セカンダリディスプレイは、デバイスが少なくともAndroidを実行している場合にのみ制御できます 10 (それ以外の場合は読み取り専用としてミラー化されます)。

起きて

デバイスが接続されているときに遅延後にデバイスがスリープしないようにするには:

scrcpy --stay-awake
scrcpy -w

初期状態は、scrcpy を閉じると復元されます。

画面をオフにする

スタート時にミラーリングしている間、デバイスの画面をオフにすることができます コマンドラインオプション:

scrcpy --turn-screen-off
scrcpy -S

または、いつでも+を押します。MODo

オンに戻すには、++を押します。MODShifto

Androidでは、ボタンは常に画面をオンにします。便宜上、scrcpyを介して(右クリックまたは+を介して)送信された場合、 少し遅れて画面をオフにするように強制されます(ベストエフォートで 基礎)。物理的なボタンは引き続き画面を回転させます オン。

POWER

POWER

POWER

デバイスがスリープ状態にならないようにすることも役立ちます。

scrcpy --turn-screen-off --stay-awake
scrcpy -Sw

閉じると電源がオフになります

scrcpyを閉じるときにデバイスの画面をオフにするには:

scrcpy --power-off-on-close

起動時の電源オン

デフォルトでは、起動時にデバイスの電源がオンになります。

この動作を防ぐには:

scrcpy --no-power-on

タッチを表示

プレゼンテーションの場合、物理的なタッチを示すと便利な場合があります(物理的な デバイス)。

Android では、この機能が [開発者向けオプション] で提供されています。

Scrcpy provides an option to enable this feature on start and restore the initial value on exit:

scrcpy --show-touches
scrcpy -t

Note that it only shows physical touches (by a finger on the device).

Disable screensaver

By default, scrcpy does not prevent the screensaver from running on the computer.

To disable it:

scrcpy --disable-screensaver

Input control

Rotate device screen

Press + to switch between portrait and landscape modes.MODr

Note that it rotates only if the application in foreground supports the requested orientation.

Copy-paste

Any time the Android clipboard changes, it is automatically synchronized to the computer clipboard.

Any shortcut is forwarded to the device. In particular:Ctrl

• Ctrl+c typically copies
• Ctrl+x typically cuts
• Ctrl+v typically pastes (after computer-to-device clipboard synchronization)

This typically works as you expect.

The actual behavior depends on the active application though. For example, Termux sends SIGINT on + instead, and K-9 Mail composes a new message.Ctrlc

To copy, cut and paste in such cases (but only supported on Android >= 7):

• MOD+c injects

  COPY

• MOD+x injects

  CUT

• MOD+v injects (after computer-to-device clipboard synchronization)

  PASTE

In addition, ++ injects the computer clipboard text as a sequence of key events. This is useful when the component does not accept text pasting (for example in Termux), but it can break non-ASCII content.MODShiftv

WARNING: Pasting the computer clipboard to the device (either via + or +) copies the content into the Android clipboard. As a consequence, any Android application could read its content. You should avoid pasting sensitive content (like passwords) that way.CtrlvMODv

Some Android devices do not behave as expected when setting the device clipboard programmatically. An option is provided to change the behavior of + and + so that they also inject the computer clipboard text as a sequence of key events (the same way as ++).

--legacy-paste

To disable automatic clipboard synchronization, use .

--no-clipboard-autosync

Pinch-to-zoom

To simulate "pinch-to-zoom": +click-and-move.Ctrl

More precisely, hold down while pressing the left-click button. Until the left-click button is released, all mouse movements scale and rotate the content (if supported by the app) relative to the center of the screen.Ctrl

Technically, scrcpy generates additional touch events from a "virtual finger" at a location inverted through the center of the screen.

Physical keyboard simulation (HID)

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

Alternatively, can simulate a physical USB keyboard on Android to provide a better input experience (using USB HID over AOAv2): the virtual keyboard is disabled and it works for all characters and IME.

scrcpy

However, it only works if the device is connected via USB.

Note: On Windows, it may only work in OTG mode, not while mirroring (it is not possible to open a USB device if it is already open by another process like the adb daemon).

To enable this mode:

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 using 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.

This settings page can be started directly:

adb shell am start -a android.settings.HARD_KEYBOARD_SETTINGS

However, the option is only available when the HID keyboard is enabled (or when a physical keyboard is connected).

Physical mouse simulation (HID)

Similarly to the physical keyboard simulation, it is possible to simulate a physical mouse. Likewise, it only works if the device is connected by USB.

By default, scrcpy uses Android mouse events injection with absolute coordinates. By simulating a physical mouse, a mouse pointer appears on the Android device, and relative mouse motion, clicks and scrolls are injected.

To enable this mode:

scrcpy --hid-mouse
scrcpy -M  # short version

You can also add to forward all mouse buttons.

--forward-all-clicks

When this mode is enabled, the computer mouse is "captured" (the mouse pointer disappears from the computer and appears on the Android device instead).

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

OTG

It is possible to run scrcpy with only physical keyboard and mouse simulation (HID), as if the computer keyboard and mouse were plugged directly to the device via an OTG cable.

In this mode, (USB debugging) is not necessary, and mirroring is disabled.

adb

To enable OTG mode:

scrcpy --otg
# Pass the serial if several USB devices are available
scrcpy --otg -s 0123456789abcdef

It is possible to enable only HID keyboard or HID mouse:

scrcpy --otg --hid-keyboard              # keyboard only
scrcpy --otg --hid-mouse                 # mouse only
scrcpy --otg --hid-keyboard --hid-mouse  # keyboard and mouse
# for convenience, enable both by default
scrcpy --otg                             # keyboard and mouse

Like and , it only works if the device is connected by USB.

--hid-keyboard

--hid-mouse

Text injection preference

Two kinds of events are generated when typing text:

• key events, signaling that a key is pressed or released;
• text events, signaling that a text has been entered.

By default, letters are injected using key events, so that the keyboard behaves as expected in games (typically for WASD keys).

But this may cause issues. If you encounter such a problem, you can avoid it by:

scrcpy --prefer-text

(but this will break keyboard behavior in games)

On the contrary, you could force to always inject raw key events:

scrcpy --raw-key-events

These options have no effect on HID keyboard (all key events are sent as scancodes in this mode).

Key repeat

By default, holding a key down generates repeated key events. This can cause performance problems in some games, where these events are useless anyway.

To avoid forwarding repeated key events:

scrcpy --no-key-repeat

This option has no effect on HID keyboard (key repeat is handled by Android directly in this mode).

Right-click and middle-click

By default, right-click triggers BACK (or POWER on) and middle-click triggers HOME. To disable these shortcuts and forward the clicks to the device instead:

scrcpy --forward-all-clicks

File drop

Install APK

To install an APK, drag & drop an APK file (ending with ) to the scrcpy window.

.apk

There is no visual feedback, a log is printed to the console.

Push file to device

To push a file to on the device, drag & drop a (non-APK) file to the scrcpy window.

/sdcard/Download/

There is no visual feedback, a log is printed to the console.

The target directory can be changed on start:

scrcpy --push-target=/sdcard/Movies/

Audio forwarding

Audio is not forwarded by scrcpy. Use sndcpy.

Also see issue #14.

Shortcuts

In the following list, is the shortcut modifier. By default, it's (left) or (left) .MODAltSuper

It can be changed using . Possible keys are , , , , and . For example:

--shortcut-mod

lctrl

rctrl

lalt

ralt

lsuper

rsuper

# use RCtrl for shortcuts
scrcpy --shortcut-mod=rctrl

# use either LCtrl+LAlt or LSuper for shortcuts
scrcpy --shortcut-mod=lctrl+lalt,lsuper

Super is typically the Windows or Cmd key.

HOME

BACK

APP_SWITCH

MENU

VOLUME_UP

VOLUME_DOWN

POWER

¹Double-click on black borders to remove them.
²Right-click turns the screen on if it was off, presses BACK otherwise.
³4th and 5th mouse buttons, if your mouse has them.
⁴For react-native apps in development,

MENU

Shortcuts with repeated keys are executed by releasing and pressing the key a second time. For example, to execute "Expand settings panel":

1. Press and keep pressing .MOD
2. Then double-press .n
3. Finally, release .MOD

All +key shortcuts are forwarded to the device, so they are handled by the active application.Ctrl

Custom paths

To use a specific binary, configure its path in the environment variable :

adb

ADB

ADB=/path/to/adb scrcpy

To override the path of the file, configure its path in .

scrcpy-server

SCRCPY_SERVER_PATH

To override the icon, configure its path in .

SCRCPY_ICON_PATH

Why the name scrcpy?

A colleague challenged me to find a name as unpronounceable as gnirehtet.

strcpy

scrcpy

How to build?

See BUILD.

Common issues

See the FAQ.

Developers

Read the developers page.

ライセンス

Copyright (C) 2018 Genymobile
Copyright (C) 2018-2022 Romain Vimont

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

記事

• scrcpy の紹介
• Scrcpyがワイヤレスで動作するようになりました

接触

バグに遭遇した場合は、まずFAQを読んでから、問題をオープンしてください。

一般的な質問やディスカッションでは、次のものも使用できます。

• Reddit:

  r/scrcpy

• ツイッター: @scrcpy_app