# escrcpy

**Repository Path**: viarotel-org/escrcpy

## Basic Information

- **Project Name**: escrcpy
- **Description**: 📱 优雅而强大的跨平台 Android 设备控制工具，基于 Scrcpy 的 Electron 应用,支持无线连接和多设备管理,让您的电脑成为 Android 的完美伴侣。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: https://viarotel.eu.org/zhHans/
- **GVP Project**: Yes

## Statistics

- **Stars**: 946
- **Forks**: 248
- **Created**: 2023-09-16
- **Last Updated**: 2026-04-04

## Categories & Tags

**Categories**: android-modules

**Tags**: scrcpy, Android, ADB, GUI, mirroring

## README

<div style="display:flex;">
  <img src="https://cdn.jsdelivr.net/gh/viarotel/resources@latest/logos/escrcpy.png" alt="viarotel-escrcpy" width="108px">
</div>

# Escrcpy

[![GitCode](https://gitcode.com/viarotel-org/escrcpy/star/badge.svg)](https://gitcode.com/viarotel-org/escrcpy)
[![Gitee](https://gitee.com/viarotel-org/escrcpy/badge/star.svg?theme=dark)](https://gitee.com/viarotel-org/escrcpy)
[![GitHub](https://img.shields.io/github/stars/viarotel-org/escrcpy?label=Github%20Stars)](https://github.com/viarotel-org/escrcpy)
[![zread](https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff)](https://zread.ai/viarotel-org/escrcpy)

📱 使用图形化的 Scrcpy 显示和控制您的 Android 设备[English Document](https://github.com/viarotel-org/escrcpy/blob/main/README.md)

<div style="display:flex;">
  <img src="https://cdn.jsdelivr.net/gh/viarotel/resources@latest/screenshots/escrcpy/zh-CN/overview.png?version=2.5.1" alt="viarotel-escrcpy" width="100%">
</div>

## 特点

- 🖥️ **内嵌镜像**：独立内嵌窗口，自动适配分辨率与屏幕方向，内置一体化快捷操作
- 🔄 **多设备群控**：单窗口同控多台设备，广播输入，支持批量截图与 APK 安装
- 🎛️ **集成控制栏**：可拖拽排序的紧凑侧边栏，涵盖旋转、截图、应用、文件、终端、AI 助手与自动化
- 🤖 **智能控制**：基于 AutoGLM 的自然语言指令，智能操控 Android 设备
- 🏃 **自动化执行**：自动化流程并行运行，支持多设备同步操作
- 🪟 **多设备管理**：可视化窗口编排，统一管理所有已连接设备
- 📡 **无线连接**：无线 ADB 连接，支持 Gnirehtet 反向供网
- ⚡ **Scrcpy 内核**：高性能、低延迟屏幕镜像与控制

## 安装

### 通过发布的软件包手动安装

查看 [发布地址](https://github.com/viarotel-org/escrcpy/releases)

### macOS 可以通过 Homebrew 安装

参阅 [homebrew-escrcpy](https://github.com/viarotel-org/homebrew-escrcpy)

## 文档

- [快速上手](https://viarotel.eu.org/zhHans/guide/started)
- [快捷键](https://viarotel.eu.org/zhHans/reference/scrcpy/shortcuts)
- [设备操作](https://viarotel.eu.org/zhHans/guide/operation)
- [偏好设置](https://viarotel.eu.org/zhHans/guide/preferences)
- [反向供网](https://viarotel.eu.org/zhHans/reference/gnirehtet/)

## 开发人员

如果你是开发人员，希望运行或帮助改进该项目请参阅 [开发文档](https://github.com/viarotel-org/escrcpy/blob/main/develop.md)

## 获得帮助

因为是开源项目 全靠爱发电 所以支持有限 更新节奏不固定

- [常见问题](https://viarotel.eu.org/zhHans/help/escrcpy)
- [反馈问题](https://github.com/viarotel-org/escrcpy/issues)
- [联系邮箱](mailto:viarotel@qq.com)

## 下一步做什么？

[里程碑](https://viarotel.eu.org/zhHans/guide/milestones)

## 致谢

该项目的诞生离不开以下开源项目

- [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/)
- [autoglm.js](https://github.com/FliPPeDround/autoglm.js)
- [tangoadb](https://tangoadb.dev/)

## 友情链接

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

## 捐赠项目

如果该项目帮到你的话，可以请我喝杯咖啡，让我更有精神完善该项目 😛

<div style="display:flex;">
  <img src="https://cdn.jsdelivr.net/gh/viarotel/resources@latest/donate/viarotel-wepay.png" alt="viarotel-wepay" width="30%">
  <img src="https://cdn.jsdelivr.net/gh/viarotel/resources@latest/donate/viarotel-alipay.png" alt="viarotel-alipay" width="30%">
  <a href="https://www.paypal.com/paypalme/viarotel" target="_blank" rel="noopener noreferrer">
    <img src="https://cdn.jsdelivr.net/gh/viarotel/resources@latest/donate/viarotel-paypal.png" alt="viarotel-paypal" width="30%">
  </a>
</div>

## 贡献者

感谢他们的所做的一切贡献！

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

## Star 历史

[![Star History Chart](https://api.star-history.com/svg?repos=viarotel-org/escrcpy&type=Date)](https://star-history.com/#viarotel-org/escrcpy&Date)