Genymobile / scrcpy

> [!WARNING]
> **This GitHub repo ( ) is the only official
source for the project. Do not download releases from random websites, even if
their name contains `scrcpy`.**
# scrcpy (v5.0.1)
_pronounced "**scr**een **c**o**py**"_
This application mirrors Android devices (video and audio) connected via USB or
TCP/IP and allows control using the
computer's keyboard and mouse. It does not require _root_ access or an app
installed on the device. It works on _Linux_, _Windows_, and _macOS_.
It focuses on:
 - **lightness**: native, displays only the device screen
 - **performance**: 30~120fps, depending on the device
 - **quality**: 1920×1080 or above
 - **low latency**: [35~70ms][lowlatency]
 - **low startup time**: ~1 second to display the first image
 - **non-intrusiveness**: nothing is left installed on the Android device
 - **user benefits**: no account, no ads, no internet required
 - **freedom**: free and open source software
[lowlatency]: https://github.com/Genymobile/scrcpy/pull/646
Its features include:
 - audio forwarding (Android 11+)
 - recording
 - virtual display
 - mirroring with Android device screen off
 - copy-paste in both directions
 - configurable quality
 - camera mirroring (Android 12+)
 - mirroring as a webcam (V4L2) (Linux-only)
 - physical [keyboard][hid-keyboard] and [mouse][hid-mouse] simulation (HID)
 - gamepad support
 - OTG mode
 - and more…
[hid-keyboard]: doc/keyboard.md#physical-keyboard-simulation
[hid-mouse]: doc/mouse.md#physical-mouse-simulation
## Prerequisites
The Android device requires at least API 21 (Android 5.0).
Audio forwarding is supported for API >= 30 (Android 11+).
Make sure you [enabled USB debugging][enable-adb] on your device(s).
[enable-adb]: https://developer.android.com/studio/debug/dev-options#enable
On some devices (especially Xiaomi), you might get the following error:
 [code] 
In that case, you need to enable [an additional option][control] `USB debugging
(Security Settings)` (this is an item different from `USB debugging`) to control
it using a keyboard and mouse. Rebooting the device is necessary once this
option is set.
[control]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323
Note that USB debugging is not required to run scrcpy in OTG mode.
## Get the app
 - Linux
 - Windows (read how to run)
 - macOS
## Must-know tips
 - Reducing resolution may greatly improve performance
 (`scrcpy -m1024`)
 - _Right-click_ triggers `BACK`
 - _Middle-click_ triggers `HOME`
 - Alt + f toggles fullscreen
 - There are many other shortcuts
## Usage examples
There are a lot of options, documented in separate pages.
Here are just some common examples.
 - Capture the screen in H.265 (better quality), limit the size to 1920, limit
 the frame rate to 60fps, disable audio, and control the device by simulating
 a physical keyboard:
 [code] 
 - Start VLC in a new virtual display (separate from the device display):
 [code] 
 - Start VLC in a new _flex_ display using H.265 with a bitrate of 16 Mb