1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
| D:\Desktop\test\CMD\phone>scrcpy --help
Usage: scrcpy [options]
Options:
--always-on-top
Make scrcpy window always on top (above other windows).
-b, --bit-rate value
Encode the video at the given bit-rate, expressed in bits/s.
Unit suffixes are supported: 'K' (x1000) and 'M' (x1000000).
Default is 8000000.
--codec-options key[:type]=value[,...]
Set a list of comma-separated key:type=value options for the
device encoder.
The possible values for 'type' are 'int' (default), 'long',
'float' and 'string'.
The list of possible codec options is available in the
Android documentation:
<https://d.android.com/reference/android/media/MediaFormat>
--crop width:height:x:y
Crop the device screen on the server.
The values are expressed in the device natural orientation
(typically, portrait for a phone, landscape for a tablet).
Any --max-size value is computed on the cropped size.
--disable-screensaver
Disable screensaver while scrcpy is running.
--display id
Specify the display id to mirror.
The list of possible display ids can be listed by:
adb shell dumpsys display
(search "mDisplayId=" in the output)
Default is 0.
--encoder name
Use a specific MediaCodec encoder (must be a H.264 encoder).
--force-adb-forward
Do not attempt to use "adb reverse" to connect to the
the device.
--forward-all-clicks
By default, right-click triggers BACK (or POWER on) and
middle-click triggers HOME. This option disables these
shortcuts and forward the clicks to the device instead.
-f, --fullscreen
Start in fullscreen.
-h, --help
Print this help.
--legacy-paste
Inject computer clipboard text as a sequence of key events
on Ctrl+v (like MOD+Shift+v).
This is a workaround for some devices not behaving as
expected when setting the device clipboard programmatically.
--lock-video-orientation [value]
Lock video orientation to value.
Possible values are "unlocked", "initial" (locked to the
initial orientation), 0, 1, 2 and 3.
Natural device orientation is 0, and each increment adds a
90 degrees rotation counterclockwise.
Default is "unlocked".
Passing the option without argument is equivalent to passing
"initial".
--max-fps value
Limit the frame rate of screen capture (officially supported
since Android 10, but may work on earlier versions).
-m, --max-size value
Limit both the width and height of the video to value. The
other dimension is computed so that the device aspect-ratio
is preserved.
Default is 0 (unlimited).
-n, --no-control
Disable device control (mirror the device in read-only).
-N, --no-display
Do not display device (only when screen recording is
enabled).
--no-key-repeat
Do not forward repeated key events when a key is held down.
--no-mipmaps
If the renderer is OpenGL 3.0+ or OpenGL ES 2.0+, then
mipmaps are automatically generated to improve downscaling
quality. This option disables the generation of mipmaps.
-p, --port port[:port]
Set the TCP port (range) used by the client to listen.
Default is 27183:27199.
--prefer-text
Inject alpha characters and space as text events instead of
key events.
This avoids issues when combining multiple keys to enter a
special character, but breaks the expected behavior of alpha
keys in games (typically WASD).
--push-target path
Set the target directory for pushing files to the device by
drag & drop. It is passed as-is to "adb push".
Default is "/sdcard/Download/".
-r, --record file.mp4
Record screen to file.
The format is determined by the --record-format option if
set, or by the file extension (.mp4 or .mkv).
--record-format format
Force recording format (either mp4 or mkv).
--render-driver name
Request SDL to use the given render driver (this is just a
hint).
Supported names are currently "direct3d", "opengl",
"opengles2", "opengles", "metal" and "software".
<https://wiki.libsdl.org/SDL_HINT_RENDER_DRIVER>
--rotation value
Set the initial display rotation.
Possibles values are 0, 1, 2 and 3. Each increment adds a 90
degrees rotation counterclockwise.
-s, --serial serial
The device serial number. Mandatory only if several devices
are connected to adb.
--shortcut-mod key[+...]][,...]
Specify the modifiers to use for scrcpy shortcuts.
Possible keys are "lctrl", "rctrl", "lalt", "ralt",
"lsuper" and "rsuper".
A shortcut can consist in several keys, separated by '+'.
Several shortcuts can be specified, separated by ','.
For example, to use either LCtrl+LAlt or LSuper for scrcpy
shortcuts, pass "lctrl+lalt,lsuper".
Default is "lalt,lsuper" (left-Alt or left-Super).
-S, --turn-screen-off
Turn the device screen off immediately.
-t, --show-touches
Enable "show touches" on start, restore the initial value
on exit.
It only shows physical touches (not clicks from scrcpy).
-V, --verbosity value
Set the log level (verbose, debug, info, warn or error).
Default is info.
-v, --version
Print the version of scrcpy.
-w, --stay-awake
Keep the device on while scrcpy is running, when the device
is plugged in.
--window-borderless
Disable window decorations (display borderless window).
--window-title text
Set a custom window title.
--window-x value
Set the initial window horizontal position.
Default is "auto".
--window-y value
Set the initial window vertical position.
Default is "auto".
--window-width value
Set the initial window width.
Default is 0 (automatic).
--window-height value
Set the initial window height.
Default is 0 (automatic).
Shortcuts:
In the following list, MOD is the shortcut modifier. By default,
it's (left) Alt or (left) Super, but it can be configured by
--shortcut-mod (see above).
MOD+f
Switch fullscreen mode
MOD+Left
Rotate display left
MOD+Right
Rotate display right
MOD+g
Resize window to 1:1 (pixel-perfect)
MOD+w
Double-click on black borders
Resize window to remove black borders
MOD+h
Middle-click
Click on HOME
MOD+b
MOD+Backspace
Right-click (when screen is on)
Click on BACK
MOD+s
Click on APP_SWITCH
MOD+m
Click on MENU
MOD+Up
Click on VOLUME_UP
MOD+Down
Click on VOLUME_DOWN
MOD+p
Click on POWER (turn screen on/off)
Right-click (when screen is off)
Power on
MOD+o
Turn device screen off (keep mirroring)
MOD+Shift+o
Turn device screen on
MOD+r
Rotate device screen
MOD+n
Expand notification panel
MOD+Shift+n
Collapse notification panel
MOD+c
Copy to clipboard (inject COPY keycode, Android >= 7 only)
MOD+x
Cut to clipboard (inject CUT keycode, Android >= 7 only)
MOD+v
Copy computer clipboard to device, then paste (inject PASTE
keycode, Android >= 7 only)
MOD+Shift+v
Inject computer clipboard text as a sequence of key events
MOD+i
Enable/disable FPS counter (print frames/second in logs)
Ctrl+click-and-move
Pinch-to-zoom from the center of the screen
Drag & drop APK file
Install APK from computer
D:\Desktop\test\CMD\phone>
|