Genymobile/scrcpy

源代码：https://github.com/Genymobile/scrcpy
此 GitHub 仓库（）是本项目的唯一官方来源。请勿从随机网站下载发行版，即使其名称包含 scrcpy。

scrcpy (v4.0)

发音为 “screen copy”

此应用可将通过 USB 或 TCP/IP 连接的 Android 设备（视频和音频）镜像到计算机，并允许使用计算机的键盘和鼠标进行控制。它不需要 root 权限或在设备上安装应用。支持 Linux、Windows 和 macOS。

Linux
Windows
macOS

截图

它专注于：

• 轻量：原生实现，仅显示设备屏幕
• 性能：30~120fps，取决于设备
• 画质：1920×1080 或更高
• 低延迟：35~70ms
• 快速启动：约 1 秒显示第一帧画面
• 无侵入性：不在 Android 设备上安装任何内容
• 用户友好：无需账户、广告或互联网
• 自由：免费开源软件

其功能包括：

• 音频转发（Android 11+）
• 录制
• 虚拟显示
• 镜像时关闭 Android 设备屏幕
• 双向复制粘贴
• 可配置画质
• 摄像头镜像（Android 12+）
• 作为网络摄像头（V4L2）镜像（仅限 Linux）
• 物理键盘和鼠标模拟（HID）
• 游戏手柄支持
• OTG 模式
• 以及更多…

前提条件

Android 设备至少需要 API 21（Android 5.0）。音频转发 支持 API >= 30（Android 11+）。

请确保在设备上启用 USB 调试。

在某些设备（尤其是小米）上，可能会遇到以下错误：
Injecting input events requires the caller (or the source of the instrumentation, if any) to have the INJECT_EVENTS permission.
此时，你需要启用另一选项 USB 调试（安全设置）（此选项与 USB 调试 不同）才能通过键盘和鼠标进行控制。设置完成后需重启设备。

请注意，在 OTG 模式 下运行 scrcpy 不需要 USB 调试。

获取应用

• Linux
• Windows（阅读运行方法）
• macOS

必知技巧

• 降低分辨率 可大幅提升性能（scrcpy -m1024）
• 鼠标右键 触发 BACK
• 鼠标中键 触发 HOME
• Alt+f 切换全屏
• 还有许多其他快捷键

使用示例

有大量选项，已分别文档化。以下仅列举一些常见例子。

• 使用 H.265 捕获屏幕（更高画质），限制尺寸为 1920，帧率为 60fps，禁用音频，并通过模拟物理键盘控制设备：

  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（与设备显示器分开）：

  scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc
  

• 在新 flex 显示器中使用 H.265 以 16 Mbps 码率启动 VLC，同时保持显示器常亮：

  scrcpy --new-display -x --keep-active --start-app=org.videolan.vlc --video-codec=h265 -b16M
  

• 以 H.265、1920×1080 录制设备摄像头（及麦克风）到 MP4 文件：

  scrcpy --video-source=camera --video-codec=h265 --camera-size=1920x1080 --record=file.mp4
  

• 捕获设备前置摄像头并作为网络摄像头暴露给计算机（Linux）：

  scrcpy --video-source=camera --camera-size=1920x1080 --camera-facing=front --v4l2-sink=/dev/video2 --no-playback
  

• 在不镜像的情况下通过模拟物理键盘和鼠标控制设备（无需 USB 调试）：

  scrcpy --otg
  

• 使用连接到计算机的游戏手柄控制设备：

  scrcpy --gamepad=uhid
  scrcpy -G   # 短格式
  

用户文档

该应用提供大量功能和配置选项。文档位于以下页面：

• 连接
• 视频
• 音频
• 控制
• 键盘
• 鼠标
• 游戏手柄
• 设备
• 窗口
• 录制
• 虚拟显示
• 隧道
• OTG
• 摄像头
• Video4Linux
• 快捷键

资源

• 常见问题解答
• 翻译（可能不是最新）
• 构建说明
• 开发者
• 验证发布版本签名

文章

• Introducing scrcpy
• Scrcpy now works wirelessly
• Scrcpy 2.0, with audio

联系方式

你可以打开 issue 报告 bug、请求功能或提出一般性问题。
对于 bug 报告，请先阅读 常见问题解答，你可能马上找到问题的解决方案。

你也可以使用：

• Reddit：r/scrcpy (https://www.reddit.com/r/scrcpy)
• BlueSky：@scrcpy.bsky.social (https://bsky.app/profile/scrcpy.bsky.social)
• Twitter：@scrcpy_app (https://twitter.com/scrcpy_app)

捐赠

我是 @rom1v (https://github.com/rom1v)，scrcpy 的作者和维护者。
如果你喜欢这个应用，可以支持我的开源工作：

• GitHub Sponsors (https://github.com/sponsors/rom1v)
• Liberapay (https://liberapay.com/rom1v/)
• PayPal (https://paypal.me/rom2v)

许可

Copyright (C) 2018 Genymobile
Copyright (C) 2018-2026 Romain Vimont

Licensed under the Apache License, Version 2.0 (the “License”);
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an “AS IS” BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.