登录 注册

scrcpy (安卓投屏与控制工具)

去点 Star
其他
154,611
Stars
0
Forks
0
Watchers
0
Open Issues
未知
许可证
C
语言
创建时间
最近更新

项目能做什么

显示并控制你的 Android 设备。
来源:AI 基于仓库事实生成 · 内容以仓库实际 README 为准

使用说明 查看原始 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

前置要求

  1. Android 设备系统版本至少为 Android 5.0(API 21+)。
  2. 音频转发功能要求 Android 11+(API 30+)。
  3. 必须在设备上启用 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_.

[![Linux](https://img.shields.io/badge/Linux-download-orange?style=for-the-badge&logo=linux)](doc/linux.md)&nbsp;
[![Windows](https://img.shields.io/badge/Windows-download-blue?style=for-the-badge&logo=windows)](doc/windows.md)&nbsp;
[![macOS](https://img.shields.io/badge/macOS-download-brightgreen?style=for-the-badge&logo=apple)](doc/macos.md)&nbsp;

![screenshot](assets/screenshot-debian-600.jpg)

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 等)。
依据 尚需验证的假设
AI 基于仓库公开数据分析生成,含推测成分,不构成收益承诺。
报告会保存到 个人中心

竞品与相似项目 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
以上为通过 GitHub 官方 Search API 检索的相似项目,功能差异与优劣势需进一步人工确认,配置 AI 后可生成对比分析。

项目优势与风险

技术成熟度创建于 ,最近推送 ,发布过 54 个 Release
社区活跃Star 154,611 / Fork 0 / Issue 0(数据支持,可自行核实)
许可证未检测到(需人工确认)
主要风险上游项目方向可能变化;同赛道竞争者较多(见竞品表);热度与需求不完全等价

安装与使用

快速开始(以仓库 README 为准)
git clone https://github.com/Genymobile/scrcpy.git
cd scrcpy
# 请阅读仓库 README 获取确切安装步骤(依赖、配置、启动命令)
阅读原仓库文档
术语说明:Docker=应用容器(把程序和依赖打包运行);API Key=调用外部服务的密钥;Git Clone=把仓库代码下载到本地。常见错误:API Key 未配置 / 端口占用 / 数据库连接失败,多数项目在 README 的 Troubleshooting 章节有说明。