<div style="display:flex;"> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/86dadb58-bad4-4d0c-82b5-ee5ee2576a39.png" alt="viarotel-escrcpy" style="width: 108px;"> </div>

Escrcpy

📱 通过Electron驱动的Scrcpy图形界面显示和控制您的Android设备。中文文档

<div style="display:flex;"> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/eef86023-3b1e-4cc5-9192-5daf4ba63896.jpg" alt="viarotel-escrcpy" style="width: 100%;"> </div>

特性

• 🏃 同步：利用网页技术更快速地与Scrcpy同步
• 🤖 自动化：自动连接设备、自动执行镜像、自定义脚本、定时任务
• 💡 定制：多设备管理、独立配置、自定义备注、配置导入导出
• 🔗 反向网络共享：Gnirehtet反向网络共享
• 🎨 主题：亮色模式、暗色模式、跟随系统切换
• 😎 轻量：原生支持，仅显示设备屏幕
• ⚡️ 性能：根据设备支持30-120帧
• 🌟 画质：1920×1080或更高
• 🕒 低延迟：35~70毫秒
• 🚀 快速启动：约1秒内显示首帧
• 🙅‍♂️ 无侵入：不在Android设备上留下安装痕迹
• 🤩 用户福利：无需账号、无广告、无需联网
• 🗽 免费开源

获取软件包

查看发布地址

快速开始

USB连接

注意：如果手机提示调试授权，请点击允许

1. 在Android手机上开启开发者模式和USB调试
2. 打开Escrcpy并将Android手机连接到电脑
3. Escrcpy的设备列表应该已经检测到您的手机，点击开始镜像
4. 尽情使用吧！

WIFI连接

注意：需要在手机的无线调试页面开启无线调试以获取设备IP地址（通常为连接WIFI时分配的IP）和端口号（默认5555）

1. 按照USB连接的步骤1-2操作
2. 将获取到的设备IP地址和端口号输入Escrcpy并点击连接设备
3. Escrcpy的设备列表应该已经检测到您的手机，点击开始镜像
4. 尽情使用吧！

macOS && Linux

注意：这些平台没有集成Scrcpy，需要手动安装

1. Linux参考安装文档
2. macOS参考安装文档
3. 依赖安装成功后按照USB连接和WIFI连接的步骤操作

Gnirehtet反向网络共享

注意：macOS没有内置Gnirehtet，需要手动安装才能使用此功能安装指南。

Windows和Linux应用程序内置了Gnirehtet，可以提供从PC到Android设备的反向网络共享。

快捷键

参考scrcpy/doc/shortcuts

设备操作

批量处理

• 批量截屏
• 批量安装应用
• 批量文件管理
• 批量执行脚本
• 批量定时任务

控制模式

• 镜像
• 录制
• OTG
• 摄像头
• 自定义

设备交互栏

• 切换
• 主页
• 返回
• 通知
• 电源
• 旋转
• 音量
• 截图
• 重启
• 安装应用
• 文件管理器
• 执行脚本
• 定时任务
• Gnirehtet
• 镜像组

首选项

持续完善中。目前支持以下常用配置

常规

• 主题
• 语言
• 文件存储路径
• Adb路径
• Scrcpy路径
• Gnirehtet路径
• Scrcpy参数
• 自动连接设备
• 自动执行镜像
• Gnirehtet修复
• 调试

视频控制

• 禁用视频转发
• 最大尺寸
• 视频比特率
• 刷新率
• 视频编解码器
• 显示方向
• 屏幕裁剪
• 监视器
• 视频缓冲
• 接收器(v4l2)缓冲

设备控制

• 显示触摸点
• 保持唤醒
• 控制时关闭屏幕
• 控制后关闭屏幕
• 控制时禁用自动开屏
• 模拟辅助显示器

窗口控制

• 窗口宽度
• 窗口高度
• 窗口X坐标
• 窗口Y坐标
• 无边框模式
• 全屏模式
• 总是置顶
• 禁用屏幕保护程序

音频控制

• 禁用音频转发
• 保持设备音频
• 音频源
• 音频编解码器
• 音频比特率
• 音频缓冲
• 音频输出缓冲

音视频录制

• 录制视频格式
• 录制视频方向
• 录制时长
• 禁用视频播放
• 禁用音频播放

输入控制

• 鼠标模式
• 鼠标绑定
• 键盘模式
• 键盘注入方式

摄像头控制

• 摄像头源
• 摄像头尺寸
• 摄像头比例
• 摄像头帧率

下一步？

优先级从高到低：

1. 改进logo ✅
2. 软件更新功能 ✅
3. 录制并保存音视频 ✅
4. 设备快速交互控制栏 ✅
5. 自定义Adb和Scrcpy依赖 ✅
6. 自定义设备名称 ✅
7. 导出和导入首选项 ✅
8. 单独设备配置 ✅
9. macOS和Linux支持 ✅
10. 国际化 ✅
11. 暗黑模式 ✅
12. 反向网络共享（Gnirehtet） ✅
13. 摄像头镜像 ✅
14. 多屏协同 ✅
15. 文件推送、屏幕旋转、音频控制 ✅
16. 批量连接历史设备 ✅
17. 内置终端 ✅
18. 自动执行镜像 ✅
19. 灵活的镜像启动 ✅
20. 批量处理 ✅
21. 定时任务 ✅
22. 设备分组 🚧
23. 文件传输助手 🚧
24. 通过界面管理设备文件 🚧
25. 游戏按键映射 🚧

常见问题

连接后电脑无法检测到设备

1. 请重新拔插设备，并确保设备已授权USB调试。
2. 如果仍然不行，可能是您的电脑缺少必要的驱动程序。请使用第三方工具如驱动精灵安装驱动后重试。

无法输入中文

这是一个已知问题 - Scrcpy似乎没有测试和支持直接中文输入。建议在手机上安装能很好支持的第三方输入法，如：

• 搜狗输入法
• QQ输入法
• 谷歌拼音输入法
• Gboard

无线连接提示：目标计算机积极拒绝访问

首次无线连接可能需要配对。或者先插入USB确保连接建立和授权成功后再使用无线。

数据线连接后点击无线模式无反应

请再次点击，或点击刷新设备。一般不会超过两次点击。如果仍然不行，请提供设备型号和Android版本到Issues

为什么设备交互控制栏不设计成自动吸附的悬浮菜单？

采用悬浮菜单的方式必然会增加与Scrcpy的耦合度和同步更新的难度。许多类似的ScrcpyGUI软件都曾在这种方式上投入大量精力，最终因为更新困难而放弃开发。因此，综合考虑后我们决定采用现有的方式，并期待Scrcpy未来能原生支持交互控制栏。

部分设备连接后可以看到截图但无法操作

注意：特别是小米手机，不仅需要开启USB调试，还需要开启USB调试（安全设置），即允许通过USB调试修改权限或模拟点击。

请参考鼠标和键盘不工作的原因的详细说明

下载提示杀毒检测导致无法正常下载

反馈后，Windows Defender可能会因为缺少证书签名而偶尔阻止软件包下载。您可以尝试以下解决方案：

1. 打开Windows安全中心。
2. 选择病毒和威胁防护。
3. 在病毒和威胁防护设置中，点击管理设置。
4. 找到实时保护，如果权限允许可以尝试点击禁用。如果无法禁用实时保护，请跳过此步骤。
5. 向下滚动页面，找到排除项，点击添加或删除排除项。
6. 将下载软件包的文件夹路径添加为排除项，即将该文件夹添加到排除列表中。

获取设备列表失败或开始镜像/录制时报错

这通常是由于Adb或Scrcpy路径不正确导致的，您可以尝试以下解决方案：

1. 在菜单中选择"偏好设置"，然后点击"全局模式"右上角的重置配置按钮。
2. 进入"设备列表"页面，尝试重新启用镜像。
3. 确保您已下载并安装最新版本的Escrcpy。
4. 按下Ctrl + Shift + I打开开发者工具，检查是否有任何错误信息。
5. 如果有错误，请截图并在反馈问题页面提交您的问题，附上截图。

macOS窗口最小化后找不到系统托盘图标

这通常是由于系统托盘图标过多，导致Escrcpy图标被隐藏。尝试使用以下工具：

• iBar
• Bartender

macOS安装成功后，尝试打开时提示文件已损坏

这通常是因为软件包未签名。您可以尝试以下解决方案：

1. 打开终端并执行 sudo spctl --master-disable 以允许来自任何来源的软件。
2. 打开终端并执行 sudo xattr -r -d com.apple.quarantine [应用路径] 尝试修复损坏的软件包提示。

无法定位动态链接库Kernel32.dll上的输入点DiscardvirtualMemory

仅支持Windows 10及以上版本。

音频捕获异常导致镜像失败

这通常是因为您的计算机缺少音频输出或Android版本较低（Android 11+）。

请尝试通过"偏好设置"禁用"音频转发"功能来解决此问题。

Microsoft Store版本镜像启动错误

这是由于安装目录中的文件缺少可执行权限造成的。

您需要自定义scrcpy和adb的文件路径（确保它们具有可执行权限）。如果使用反向网络共享，也需要类似地配置gnirehtet。

获取帮助

作为一个完全由捐赠运营的开源项目，支持可能有限，更新可能没有固定的时间表。

• 问题：提交反馈
• 电子邮件：viarotel@qq.com

致谢

本项目的实现离不开以下开源项目：

• scrcpy
• adbkit
• electron
• vue
• gnirehtet

支持项目

如果这个项目对您有帮助，您可以给我买杯咖啡，让我保持精力继续改进项目！😛

[图片：微信支付二维码] [图片：支付宝二维码] [图片：PayPal支付链接]

贡献者

感谢所有的贡献！

[贡献者头像图片]

Star历史

[Star历史图表]