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)

pronounced "screen copy"

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
• 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

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 and mouse simulation (HID)
• gamepad support
• OTG mode
• and more…

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 on your device(s).

On some devices (especially Xiaomi), you might get the following error:

In that case, you need to enable an additional option 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.

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:

• 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 (not necessarily up to date)

• Build instructions

• Developers

• Verify release signatures

Articles

• Introducing scrcpy
• Scrcpy now works wirelessly
• Scrcpy 2.0, with audio

Co