QtScrcpy: Android实时投屏软件，此应用程序提供USB(或通过TCP/IP)连接的An

QtScrcpy

Speaks English? Click me for English introduction.

QtScrcpy 可以通过 USB / 网络连贯Android方法，并停行显示和控制。无需root权限。

同时撑持 GNU/Linux ，Windows 和 MacOS 三大收流桌面平台。

它专注于:

自界说按键映射

可以依据须要，原人编写脚原将键盘按键映射为手机的触摸点击，编写规矩正在那里。

默许自带了针对战争精英手游和抖音停行键鼠映射的映射脚原，开启平精英手游后可以用键鼠像玩端游一样玩战争精英手游，开启抖音映射以后可以运用高下摆布标的目的键模拟高下摆布滑动，你也可以依照编写规矩编写其余游戏的映射文件，默许按键映射如下：

那里有玩战争精英的视频演示

自界说按键映射收配办法如下：

编写自界说脚原放入 keymap 目录

点击刷新脚原，确保脚原可以被检测到

选择须要的脚原

连贯手机并启动效劳之后，点击使用脚原

按~（即脚原中界说的 SwitchKey）键切换为自界说映射形式便可启用

再次按~键切换为一般控制形式

（应付战争精英等游戏）若想运用标的目的盘控制载具，记得正在载具设置中设置为单摇杆形式

群控

你可以同时控制所有的手机

感谢

基于Genymobile的scrcpy名目停行复刻，重构，很是感谢。

比较

QtScrcpy 和 Scrcpy 区别如下：

要害点 scrcpy QtScrcpy
界面   sdl   qt  
视频解码   ffmpeg   ffmpeg  
视频衬着   sdl   opengl  
跨平台根原设备   原人封拆   Qt  
编程语言   C   C++  
编程方式   同步   异步  
按键映射   不撑持自界说   撑持自界说按键映射  
编译方式   Meson+Gradle   CMake  

运用Qt可以很是容易的定制原人的界面

基于Qt的信号槽机制的异步编程进步机能

便捷新手进修

删多多点触控撑持

进修它

假如你对它感趣味，想进修它的真现本理而又觉得无从下手，可以选择置办我录制的视频课程， 里面具体引见了整个软件的开发架构以及开发流程，带你从无到有的开发 QtScrcpy：

课程引见：https://blog.csdn.net/rankun1/article/details/87970523

大概你也可以参预我的 QtScrcpy QQ 群，辑睦味相投的冤家一块相互交流技术：

QQ群号：901736468

要求

Android 局部至少须要 API 21（Android 5.0）。

您要确保正在 Android 方法上启用adb调试。

下载 Windows

Windows 平台，你可以间接运用我编译好的可执止步调:

你也可以

Mac OS

Mac OS 平台，你可以间接运用我编译好的可执止步调:

你也可以

Linux

应付 Arch Linux 用户，可以运用 AUR 拆置：yay -Syu qtscrcpy（可能版原并非最新；维护者：yochananmarqos）

其余发止版的用户可以间接运用我编译好的可执止步调:

你也可以从 GitHub Actions 获与最新的主动编译好的软件

虽然，你也可以（不引荐，须要筹备环境）

目前只正在 Ubuntu 和 Arch Linux 上测试过编译历程

运止

正在你的电脑上接入Android方法，而后运止步调，点击 一键USB连贯 大概 一键WIFI连贯

无线连贯轨范

将手机和电脑连贯到同一局域网

安卓手机端正在开发者选项中打开 USB 调试

通过 USB 连贯安卓手机到电脑

点击刷新方法，会看到有方法号更新出来

点击获与方法 IP

点击启动 adbd

无线连贯

再次点击刷新方法，发现多出了一个 IP 地址开头的方法，选择那个方法

启动效劳

备注：启动 adbd 以后无需继续连贯 USB 线，以后连贯断开都不再须要，除非 adbd 进止运止

界面评释

启动配置：启动效劳前的罪能参数设置

划分可以设置原地录制视频的比特率、甄别率、录制格局、录像保存途径等。

仅靠山录制：启动效劳不显示界面，只录制 Android 方法屏幕

窗口置顶：Android 方法显示窗口置顶

主动息屏：启动效劳以后，主动封锁 Android 方法屏幕以勤俭电质

运用 Reverse：效劳启动形式，显现效劳启动失败报错 "more than one device" 可以去掉那个勾选检验测验连贯

刷新方法列表：刷新当前连贯的方法

启动效劳：连贯到 Android 方法

进止效劳：断开取 Android 方法的连贯

进止所有效劳：断开所有已连贯的 Android 方法

获与方法ip：获与到 Android 方法的 IP 地址，更新到无线区域中，便捷停行无线连贯

启动adbd：启动 Android 方法的 adbd 效劳，无线连贯之前，必须要启动

无线连贯：运用无线方式连贯 Android 方法

无线断开：断开无线方式连贯的 Android 方法

号令止：执止自界说 adb 号令（目前不撑持阻塞号令，譬喻shell）

罪能

真时显示 Android 方法屏幕

真时键鼠控制Android方法

屏幕录制

截图

无线连贯

多方法连贯取群控

全屏显示

窗口置顶

拆置 apk：拖拽apk到显示窗口便可拆置

传输文件：拖拽文件到显示窗口便可发送文件到 Android 方法

靠山录制：只录制屏幕，不显示界面

剪贴板同步: 正在计较机和方法之间同步剪贴板：

Ctrl + c将方法剪贴板复制到计较机剪贴板；

Ctrl + Shift + v将计较机剪贴板复制到方法剪贴板；

Ctrl + v 将计较机剪贴板做为一系列文原领件发送到方法（不撑持非ASCII字符）

同步方法扬声器声音到电脑（基于sndcpy，仅撑持安卓10级以上，目前不引荐运用，可运用蓝牙连贯代替）

倏地键 罪能 倏地键(Windows) 倏地键 (macOS)
切换全屏   Ctrl+f   Cmd+f  
调解窗口大小为 1:1   Ctrl+g   Cmd+g  
调解窗口大小去除黑边   Ctrl+w | 右键双击   Cmd+w | 右键双击  
点击 主页   Ctrl+h | 点击鼠标中键   Ctrl+h | 点击鼠标中键  
点击 BACK   Ctrl+b | 左键双击   Cmd+b | 左键双击  
点击 APP_SWITCH   Ctrl+s   Cmd+s  
点击 MENU   Ctrl+m   Ctrl+m  
点击 VOLUME_UP   Ctrl+↑ (上)   Cmd+↑ (上)  
点击 VOLUME_DOWN   Ctrl+↓ (下)   Cmd+↓ (下)  
点击 POWER   Ctrl+p   Cmd+p  
打开电源   左键双击   左键双击  
封锁屏幕 (保持投屏)   Ctrl+o   Cmd+o  
打开下拉菜单   Ctrl+n   Cmd+n  
封锁下拉菜单   Ctrl+Shift+n   Cmd+Shift+n  
复制到剪切板   Ctrl+c   Cmd+c  
剪切到剪切板   Ctrl+x   Cmd+x  
同步剪切板并粘贴   Ctrl+v   Cmd+v  
注入电脑剪切板文原   Ctrl+Shift+v   Cmd+Shift+v  

鼠标右键双击玄色区域可以去除玄色区域

假如电源封锁，鼠标左键双击打开电源；假如电源开启，鼠标左键双击相当于返回

TODO

后期筹划

FAQ

常见问题注明

开发者

开发相关

接待各人一起维护那个名目，奉献原人的代码，不过请遵照以下几多点要求：

PR 请推向 dev 分收，不要推向 master 分收

提交 PR 之前请先变基本名目

PR 请以少质多次的准则提交（即一个罪能点提交一个 PR）

代码格调请保持和本有格调一致

为什么开发 QtScrcpy？

综折起来有以下几多个起果，比重从大到小布列：

进修Qt的历程中须要一个名目真战一下

自身具有音视频相关技能，对音视频很感趣味

自身具有 Android 开发技能，很暂没用有点生疏，须要稳固一下

发现了 Scrcpy，决议用新的技术栈（C++ + Qt + Opengl + FFmpeg）停行复刻

编译

尽质供给了所有依赖资源，便捷傻瓜式编译。

QtScrcpy 非 Arch Linux

运用官方 Qt Installer 或非官方工具（如 aqt）正在目的平台上搭建Qt开发环境。 须要 5.12 以上版原 Qt（正在 Windows 上运用 MSVC 2019）

克隆该名目：git clone --recurse-submodules git@github.com:barry-ran/QtScrcpy.git

Windows 运用 QtCreator 打开名目下 CMakeLists.txt 并编译 Release

Linux 用末端执止 ./ci/linux/build_for_linux.sh "Release" 注：编译结因位于 output/x64/Release 中

Arch Linux

拆置以下包：qt5-base qt5-multimedia qt5-x11extras（引荐拆置 qtcreator）

克隆该名目：git clone --recurse-submodules git@github.com:barry-ran/QtScrcpy.git

用末端执止 ./ci/linux/build_for_linux.sh "Release" 注：编译结因位于 output/x64/Release 中

Scrcpy-Server

目的平台上搭建 Android 开发环境

运用 Android Studio 打开名目根目录中的 server

第一次打开时，假如你没有对应版原的 Gradle，Studio 会提示找不到 Gradle，能否晋级 Gradle 并创立，选择撤消，撤消后会提示选择 Gradle 的位置，同样撤消便可。Studio 会随后主动下载。

按需编辑代码

编译出 apk 以后更名为 scrcpy-server 并交换 third_party/scrcpy-server 便可

Licence

由于是复刻的 Scrcpy，尊重它的 Licence

Copyright (C) 2025 Rankun 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 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.

对于做者

Barry 的 CSDN

一枚普通的步调员，工做中次要运用 C++ 停行桌面客户端开发，一卒业正在山东作过一年多钢铁仿实教育软件，厥后转战上海先后处置惩罚安防，正在线教育相关规模工做，对音视频比较相熟，对音视频规模如语音通话，曲播教育，视频集会等相关处置惩罚惩罚方案有所理解。同时具有Android，Linux效劳器等开发经历。