scrcpy

> [!WARNING] > **This GitHub repo (<https://github.com/Genymobile/scrcpy>) is the only official source for the project. Do not download releases from random websites, even if their name contains `scrcpy`.** scrcpy (v4.1) <img src="app/data/scrcpy.svg" width="128" height="128" alt="scrcpy" align="right" /> _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_. &nbsp; &nbsp; &nbsp; 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: 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` - <kbd>Alt</kbd>+<kbd>f</kbd> 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: - Start VLC in a new virtual display (separate from the device display): - Start VLC in a new _flex_ display using H.265 with a bitrate of 16 Mbps, while keeping the display active so it does not turn off: - Record the device camera in H.265 at 1920x1080 (and microphone) to an MP4 file: - Capture the device front camera and expose it as a webcam on the computer (on Linux): - Control the device without mirroring by simulating a physical keyboard and mouse (USB debugging not required): - Control the device using gamepads plugged into the computer: User documentation The application provides a lot of features and configuration options. They are documented in the following pages: - Connection - Video - Audio - Control - Keyboard - Mouse - Gamepad - Device - Window - Recording - Virtual display - Tunnels - OTG - Camera - Video4Linux - Shortcuts Resources - FAQ - [Translations][wiki] (not necessarily up to date) - Build instructions - Developers - Verify release signatures [wiki]: https://github.com/Genymobile/scrcpy/wiki Articles - [Introducing scrcpy][article-intro] - [Scrcpy now works wirelessly][article-tcpip] - [Scrcpy 2.0, with audio][article-scrcpy2] [article-intro]: https://blog.rom1v.com/2018/03/introducing-scrcpy/ [article-tcpip]: https://www.genymotion.com/blog/open-source-project-scrcpy-now-works-wirelessly/ [article-scrcpy2]: https://blog.rom1v.com/2023/03/scrcpy-2-0-with-audio/ Co