# Escrcpy

[](https://gitcode.com/viarotel-org/escrcpy)
[](https://gitee.com/viarotel-org/escrcpy)
[](https://github.com/viarotel-org/escrcpy)
[](https://deepwiki.com/viarotel-org/escrcpy)
[](https://zread.ai/viarotel-org/escrcpy)

📱 Display and control your Android device graphically with scrcpy. [中文文档](https://github.com/viarotel-org/escrcpy/blob/main/README-CN.md)


  


<sub>Escrcpy focuses on a stable integration foundation; some advanced features come from the private extension repository EscrcpyX and are offered on a paid basis.</sub>

## Features

- 🖥️ **Inset Mirror**: Dedicated embedded window, auto-fits screen resolution and orientation, with integrated one-tap shortcuts
- ⌨️ **Keyboard Mapping**: Configure touch, joystick, swipe, scroll, and automation mappings directly on the embedded mirror
- 🔄 **Multi-Device Control**: Control multiple devices simultaneously in a single window, broadcast input, with batch screenshot and APK install support
- 🎛️ **Integrated Control Bar**: Compact, draggable sidebar with reorderable controls: rotation, screenshot, apps, files, terminal, AI assistant, and automation
- 🤖 **Copilot**: AI assistant built on MCP protocol for intelligent Android device control with multi-model chat support
- 🏃 **Automation Script**: Visual step-by-step workflow orchestration with screen image recognition and batch execution across multiple devices
- 🪟 **Multi-Device Management**: Visual window orchestration for centralized management of all connected devices
- 📡 **Wireless Connection**: Wireless ADB connections with LAN auto-discovery and Gnirehtet reverse tethering support
- 🔑 **Shortcut Management**: Customizable global hotkeys for quick device operations
- ⚡ **Scrcpy Core**: High-performance, low-latency screen mirroring and control

## Installation

### Manual Installation via Released Packages

Check the [Releases Page](https://github.com/viarotel-org/escrcpy/releases)

### macOS Installation via Homebrew

Refer to [homebrew-escrcpy](https://github.com/viarotel-org/homebrew-escrcpy)

## Documentation

- [Getting Started](https://viarotel.eu.org/guide/started)
- [Shortcuts](https://viarotel.eu.org/reference/scrcpy/shortcuts)
- [Device Operations](https://viarotel.eu.org/guide/operation)
- [Preferences](https://viarotel.eu.org/guide/preferences)
- [Reverse Tethering](https://viarotel.eu.org/reference/gnirehtet/)

## For Developers

If you are a developer and wish to run or help improve this project, refer to the [Development Documentation](https://github.com/viarotel-org/escrcpy/blob/main/develop.md)

## Get Help

As an open-source project powered by passion, support is limited, and updates are irregular.

- [FAQ](https://viarotel.eu.org/help/escrcpy)
- [Report Issues](https://github.com/viarotel-org/escrcpy/issues)
- [Contact Email](mailto:viarotel@qq.com)

## What's Next?

[Milestones](https://viarotel.eu.org/guide/milestones)

## Acknowledgments

This project owes its existence to the following open-source projects:

- [scrcpy](https://github.com/Genymobile/scrcpy)
- [adbkit](https://github.com/DeviceFarmer/adbkit)
- [electron](https://www.electronjs.org/)
- [vue](https://vuejs.org/)
- [gnirehtet](https://github.com/Genymobile/gnirehtet/)
- [yadb](https://github.com/nicepkg/yadb)
- [tangoadb](https://tangoadb.dev/)

## Friendly Links

- [ADB Device Manager 2](https://github.com/Shrey113/Adb-Device-Manager-2)

## Donate

If this project has helped you, consider buying me a coffee to keep me motivated for further improvements 😛


  
  
  <a href="https://www.paypal.com/paypalme/viarotel" target="_blank" rel="noopener noreferrer">
    
  </a>


You can also support me through the AiFaDian platform.

 [](https://afdian.com/a/viarotel) 

## Contributors

Thanks to all who contributed!

[Contributors](https://github.com/viarotel/escrcpy/graphs/contributors)