scrcpy (安卓投屏与控制工具)
项目能做什么
使用说明 查看原始 README 原仓库文档
项目简介
scrcpy(发音为 screen copy)是一款开源免费的 Android 设备投屏与控制工具。它支持通过 USB 或 TCP/IP(无线)连接 Android 设备,并在电脑上使用键盘和鼠标进行操作。
使用该工具无需获取 Android 设备的 root 权限,也无需在手机上安装任何 App。支持平台包括 Linux、Windows 和 macOS。
安全警告:GitHub 官方仓库(https://github.com/Genymobile/scrcpy)是该项目的唯一官方来源,切勿从非官方网站下载带有
scrcpy名称的安装包。
核心功能
- 轻量高性能:原生渲染,仅显示设备屏幕;帧率可达 30~120 fps,延迟极低(35~70ms),启动约 1 秒。
- 高质量显示:支持 1920×1080 及以上分辨率,画质参数可配置。
- 音频转发:支持将 Android 11+ 设备的音频传输至电脑播放。
- 双向控制与交互:电脑与手机双向共享剪切板(Copy-Paste);支持模拟物理键盘与鼠标(HID)以及游戏手柄(Gamepad)。
- 屏幕控制:支持息屏状态下投屏与控制,支持创建独立的虚拟显示屏(Virtual Display)。
- 录屏与摄像头:支持屏幕录制;支持镜像 Android 12+ 摄像头,在 Linux 上还可通过 V4L2 映射为电脑虚拟摄像头。
- OTG 模式:仅通过电脑键鼠控制手机,无需开启 USB 调试。
- 无侵入与完全免费:手机端不残留任何文件,免登录、无广告、不需要联网。
适合谁用
(此部分原文未单独列出) 适合需要在电脑端调试/演示 App 的 Android 开发者、需要用键鼠操控手机摸鱼或办公的极客用户、手游键鼠操控玩家,以及需要利用旧手机作为电脑摄像头/麦克风的内容创作者。
安装步骤
此部分原文未说明具体安装命令,仅提供了各操作系统的独立文档链接,详情请查看原仓库:
* Linux:参考 doc/linux.md
* Windows:参考 doc/windows.md
* macOS:参考 doc/macos.md
前置要求
- Android 设备系统版本至少为 Android 5.0(API 21+)。
- 音频转发功能要求 Android 11+(API 30+)。
- 必须在设备上启用 USB 调试(USB debugging)(OTG 模式除外)。
配置说明与常用技巧
基础操作小贴士
- 降低分辨率提升性能:若遇卡顿,可限制分辨率,例如
scrcpy -m1024。 - 鼠标右键:触发手机
返回键(BACK)。 - 鼠标中键:触发手机
主页键(HOME)。 - 全屏切换:快捷键
Alt + f。
常用运行命令示例
-
H.265 编码 + 限制画质与帧率 + 物理键盘模拟:
bash # 完整参数 scrcpy --video-codec=h265 --max-size=1920 --max-fps=60 --no-audio --keyboard=uhid # 简写形式 scrcpy --video-codec=h265 -m1920 --max-fps=60 --no-audio -K -
在新的虚拟屏幕中启动指定应用(如 VLC):
bash scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc -
使用 H.265 + 16 Mbps 码率启动新弹性显示屏,并保持常亮:
bash scrcpy --new-display -x --keep-active --start-app=org.videolan.vlc --video-codec=h265 -b16M -
录制设备摄像头(含麦克风)为 MP4 文件:
bash scrcpy --video-source=camera --video-codec=h265 --camera-size=1920x1080 --record=file.mp4 -
Linux 下将前置摄像头映射为电脑虚拟摄像头(Webcam):
bash scrcpy --video-source=camera --camera-size=1920x1080 --camera-facing=front --v4l2-sink=/dev/video2 --no-playback -
OTG 模式(仅用键鼠控制手机,无需投屏与 USB 调试):
bash scrcpy --otg -
使用手柄控制设备:
bash scrcpy --gamepad=uhid # 简写形式 scrcpy -G
常见问题
1. 小米等机型出现 INJECT_EVENTS 权限错误
报错信息:
Injecting input events requires the caller (or the source of the instrumentation, if any) to have the INJECT_EVENTS permission.
解决方案:在手机开发者选项中,找到并开启 「USB 调试(安全设置)」(该项与普通的「USB 调试」不同)。开启后必须重启手机才能正常通过键盘鼠标控制设备。
原始 README 摘录(英文原文,节选前 3000 字符)
> [!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 (v5.0.1) <img src="app/data/scrcpy.svg" width="128" height="128" alt="scrcpy" align="right" /> _pronounced "**scr**een **c**o**py**"_ This application mirrors Android devices (video and audio) connected via USB or [TCP/IP](doc/connection.md#tcpip-wireless) 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_. [](doc/linux.md) [](doc/windows.md) [](doc/macos.md)  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][lowlatency] - **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 [lowlatency]: https://github.com/Genymobile/scrcpy/pull/646 Its features include: - [audio forwarding](doc/audio.md) (Android 11+) - [recording](doc/recording.md) - [virtual display](doc/virtual-display.md) - mirroring with [Android device screen off](doc/device.md#turn-screen-off) - [copy-paste](doc/control.md#copy-paste) in both directions - [configurable quality](doc/video.md) - [camera mirroring](doc/camera.md) (Android 12+) - [mirroring as a webcam (V4L2)](doc/v4l2.md) (Linux-only) - physical [keyboard][hid-keyboard] and [mouse][hid-mouse] simulation (HID) - [gamepad](doc/gamepad.md) support - [OTG mode](doc/otg.md) - and more… [hid-keyboard]: doc/keyboard.md#physical-keyboard-simulation [hid-mouse]: doc/mouse.md#physical-mouse-simulation ## Prerequisites The Android device requires at least API 21 (Android 5.0). [Audio forwarding](doc/audio.md) is supported for API >= 30 (Android 11+). Make sure you [enabled USB debugging][enable-adb] on your device(s). [enable-adb]: https://developer.android.com/studio/debug/dev-options#enable On some devices (especially Xiaomi), you might get the following error: ``` Injecting input events requires the caller (or the source of the instrumentation, if any) to have the INJECT_EVENTS permission. ``` In that case, you need to enable [an additional option][control] `USB debugging (Security Settings)` (this is an item different from `USB debugging`) to control it using a keyboard and mouse. Rebooting the device阅读完整原文
商业机会分析 AI 生成
跨平台多设备群控与自动化桌面客户端
| 产品构想 | 基于 scrcpy 底层协议封装专为批量控制设计的商业化 GUI,支持多设备同屏监控、键鼠操作一键主从同步、多开脚本录制与回放。 |
| 核心功能 | 多设备平铺网格视图、主控设备操作广播同步、无线 ADB 一键扫网连接、批量安装卸载与文件分发、预设快捷键映射配置。 |
| 目标用户 | 海外社交媒体运营矩阵人员、移动应用/游戏测试工程师、批量账号维护人员。 |
| 难度/周期 | 中等 · 1-2个月 · 成本:开发机器、多台测试用安卓机、代码签名证书(Windows/macOS) |
| 收费模式 | 按设备数买断授权或订阅制(如专业版/企业版席位)。 |
| 竞争风险 | 存在竞品群控工具的直接竞争;若用户用于黑灰产可能面临法律与合规风险。 |
| 依据 | 已验证事实 |
手游主播与内容创作专用推流套件
| 产品构想 | 针对直播和录屏场景封装低门槛工具,集成虚拟显示器、音频独占转发、高帧率输出与 OBS/直播伴侣直接对接的虚机摄像头或推流管道。 |
| 核心功能 | 针对主流直播软件的一键直通配置(V4L2/虚拟摄像头/音轨隔离)、自定义设备边框与美化外壳渲染、熄屏推流降低手机发热、按键映射投屏可视化展示。 |
| 目标用户 | 移动游戏主播、数码博主、在线教学讲师。 |
| 难度/周期 | 较低 · 3-4周 · 成本:极低(主要是界面开发与打包成本) |
| 收费模式 | 一次性买断制(Gumroad/官网自售),提供滤镜/画质增强拓展包。 |
| 竞争风险 | 开源社区已有一些免费第三方 GUI 竞品,纯易用性包装可能难以维持高客单价。 |
| 依据 | 数据支持的判断 |
轻量级云机/远程真机调试与协作服务
| 产品构想 | 利用 scrcpy 的低延迟音视频转发与虚拟显示特性,封装 WebRTC 流媒体服务,将本地机房或办公室内闲置真机云化,供分布式团队远程调试与演示。 |
| 核心功能 | 浏览器端远程查看与触控(WebRTC)、设备租用调度与权限管理、断线自动重连与 ADB 权限安全沙箱、操作日志审计。 |
| 目标用户 | 远程办公的移动开发团队、外包测试服务商、远程设备农场搭建人员。 |
| 难度/周期 | 较高 · 2-3个月 · 成本:服务器带宽成本、测试真机硬件成本 |
| 收费模式 | B2B SaaS 订阅或私有化部署买断许可证。 |
| 竞争风险 | 涉及 WebRTC 改造、网络穿透与高并发网络传输,维护成本高;市面已有成熟云测试厂商(如 Sauce Labs 等)。 |
| 依据 | 尚需验证的假设 |
竞品与相似项目 GitHub Search 真实检索
| 项目 | 中文简介 | Stars | 语言 |
|---|---|---|---|
| barry-ran/QtScrcpy | 中文介绍暂未生成 Android real-time display control software |
32,817 | C++ |
| viarotel-org/escrcpy | 中文介绍暂未生成 📱 Display and control your Android device graphically with s |
12,352 | JavaScript |
| SimonAKing/scrcpy-gui | 中文介绍暂未生成 👻 A simple & beautiful GUI application for scrcpy. |
4,184 | TypeScript |
| Shrey113/Android-Dex | 中文介绍暂未生成 Universal Samsung DeX alternative for all Android devices. R |
3,856 | HTML |
| rom1v/sndcpy | 中文介绍暂未生成 Android audio forwarding PoC (scrcpy, but for audio) |
3,569 | Java |
| yume-chan/ya-webadb | 中文介绍暂未生成 ADB in your browser |
3,287 | TypeScript |
项目优势与风险
| 技术成熟度 | 创建于 ,最近推送 ,发布过 54 个 Release |
| 社区活跃 | Star 154,611 / Fork 0 / Issue 0(数据支持,可自行核实) |
| 许可证 | 未检测到(需人工确认) |
| 主要风险 | 上游项目方向可能变化;同赛道竞争者较多(见竞品表);热度与需求不完全等价 |
安装与使用
git clone https://github.com/Genymobile/scrcpy.git cd scrcpy # 请阅读仓库 README 获取确切安装步骤(依赖、配置、启动命令)