1. Project Overview

An elegant and powerful cross-platform Android device control tool, built on Scrcpy as an Electron application. Supports wireless connections and multi-device management, making your computer the perfect companion for Android devices.

2. Open Source License

Licensed under Apache-2.0

3. Screenshots

Display and control your Android device using Scrcpy with a graphical interface, powered by Electron.

4. Feature Overview

Features

• Synchronization: Stay in sync with Scrcpy faster thanks to web technologies.

• Automation: Automatically connect devices, start mirroring, run custom scripts, and schedule tasks.

• Customization: Multi-device management, independent configurations, custom notes, and configuration import/export.

• Wireless: Quickly connect by scanning a QR code.

• Reverse Tethering: Reverse network sharing with Gnirehtet.

• Themes: Light mode, dark mode, and automatic system theme switching.

• Lightweight: Native support, displaying only the device screen.

• Performance: 30–120 frames per second, depending on the device.

• Quality: 1920×1080 or higher.

• Low Latency: 35–70 milliseconds.

• Fast Startup: Displays the first frame in approximately 1 second.

• ♂️ Non-Intrusive: Does not leave any installation files on Android devices.

• User Benefits: No account required, no ads, and no internet connection needed.

• Freedom: Free and open-source software.

5. Tech Stack

Installation

Manually install using the released software packages.

See the release page [For more details, please refer to the README.md documentation].

macOS users can install via Homebrew.

See homebrew-escrcpy.

Quick start

USB Connection

Note: If your phone prompts you to authorize USB debugging, tap Allow.

1. Enable Developer Options and USB Debugging on your Android phone.

2. Open Escrcpy and connect your Android phone to your computer.

3. Escrcpy should now detect your phone in the device list. Click Start Mirroring.

4. Enjoy!

Wi-Fi Connection

Connect by Scanning a QR Code

1. Follow steps 1–2 under USB Connection.

2. Enable Wireless Debugging in Developer Options and open its settings.

3. Tap Pair device with QR code.

4. Enjoy!

Connect via IP Address

Note: If the first wireless connection fails, you may need to pair your device wirelessly. See the FAQ.

Note: Wireless Debugging must be enabled. On the Wireless Debugging page, find your device's current wireless IP address (usually the IP address assigned when connected to Wi-Fi) and port number (default: 5555).

1. Follow steps 1–2 under USB Connection.

2. Enter the device IP address and port number in Escrcpy, then click Connect Device.

3. Escrcpy should now detect your phone in the device list. Click Start Mirroring.

4. Enjoy!

macOS && Linux

Note: Starting with Escrcpy@1.27.1+, the scrcpy binary is partially integrated, so you no longer need to install scrcpy manually.

1. Linux users can refer to the installation documentation.

2. macOS users can refer to the installation documentation.

3. After successfully installing the dependencies above, follow the same steps as for USB Connection and Wi-Fi Connection.

Gnirehtet Reverse Tethering

Note: Gnirehtet is not integrated into the macOS version. If you need to use it, install it manually. See the installation documentation.

Gnirehtet is integrated into the Windows and Linux versions to provide reverse network sharing from your PC to Android devices.

Developers

If you are a developer and want to run or help improve this project, please refer to the development documentation.

Keyboard shortcuts

See scrcpy/doc/shortcuts.

Detailed content please refer to README.md document