MYScrcpy V1.7.0
包含完整的视频、音频、控制解析,开发友好,引入即用!
采用 DearPyGui 作为主要GUI。 支持编写插件,窗口位置记忆、右键手势控制、断线重连、文件管理器、虚拟摄像头投屏、中文输入,锁屏密码解锁等功能。
高速模式使用pygame作为鼠标及键盘控制映射GUI。提供鼠标隐藏、按键事件监听等功能, 适用于第一人称相关应用的按键映射。
功能特性
插件
Virtualcam 虚拟摄像头
- 0.1.2 支持选择区域,增加提示框及提示信息
- 适配新回调
- 原有虚拟摄像头功能插件化
- 根据当前运行平台自动选择backend(OBS/unitycapture/v4l2loopback)
- 支持原尺寸/自定义尺寸输出,自定义背景填充颜色
- 支持输出预览
- 横竖屏自动切换
- 目前支持 (Edges/Gray/Cartoon) 图像转换效果
- I键开启/关闭 O键暂停/继续 P键按下暂停
Capture 截图助手 (告别苦苦手拉640x640训练图)
- 0.1.2 支持WSAD调节截图框位置/大小
- 0.1.1 支持摄像头模式截图
- 0.1.1 V键开启拉选模式,手动拉取指定区域
- 获取屏幕坐标、定位十字线
- 自定义截图框尺寸、原始或所见所截模式
- C键截图、X键锁定截图框位置 Q关闭功能
- 截取设备1:1实际图形,保持高清晰度
- 截图历史预览、自定义保存格式、批量保存
- 支持放大镜模式
- 支持自定义十字线颜色、随机颜色,粗细等,更加醒目
Unlocker Ubuntu解锁助手 1.7.0 NEW
mysc-unlocker
Ubuntu24 X11环境下解锁工具。通过解锁手机来解锁PC。
演示_CSDN
开发
- 1.7.0 适配Scrcpy 2.7,支持Gamepad
- 1.6.5 插件开发教程
- 1.6.4 统一鼠标、键盘回调方法及传参,增加过滤器
- 1.6.4 自定义插件加载路径,方便插件开发
- 1.6.3 新增鼠标抢夺模式,允许插件获取鼠标控制权,实现更多功能
- 功能说明 Window.setup_session()
- 全新插件架构!支持配置文件注入等功能 帮助文档
- 升级KVManager ValueManager,自动注册,自动管理
- 整合uiautomator2
- 支持获取视频、音频原格式流,方便二次开发
- 开箱即用
pip install mysc[full]
- 使用Session/Connection/Adapter/Args架构,一行代码获取图像
Session(adb_device, video_args=VideoArgs(1200)).va.get_image()
- 按需最小化引用。支持Termux上安装部署服务,支持局域网WEB浏览,安装部署教程
GUI
- 新增插件管理器,管理插件、自定义配置等
- 新增底部提示及日志栏,信息及时提醒,同时提供日志查看功能
- 文件管理器,支持设备文件管理,下载、上传及预览 帮助文档
- 支持Windows系统下,文件传输功能
- 使用右键手势 下|上 快速拷贝
- 也可使用 VAC -> Control -> CopyToDevice 使用
- 先选中PC中文件或文件夹(支持多选),在MYScrcpy界面绘制拷贝手势,则拷贝选中文件/文件夹至设备 /sdcard/MYScrcpy/ 文件夹下
- 先进行PC屏幕截图,在MYScrcpy界面绘制拷贝手势,则拷贝截图至设备 /sdcard/DCIM/ 文件夹下
- 若选中文本,则拷贝文本至设备剪贴板
- 支持有线、无线连接设备
- 支持设置无线端口,设置后自动重连功能
- 支持加载历史连接记录功能,自动记忆历史连接记录,快速连接
- 可根据设备配置相应连接模式,保存连接参数
- 例如若使用手机摄像头模式,则video/audio配置,control关闭,并保存为Camera配置组合
- 使用投屏,则全部配置,并保存为投屏配置组合
- 根据设备及当前连接参数,自动记忆窗口大小,同时记忆窗口旋转前位置。在横竖屏切换时,无需频繁调整窗口位置
- 支持Windows/Linux (暂无macOS设备,后期进行测试)
- 支持心跳检测,自动重连
视频
- 支持h264/h265视频流解析
- 根据设备情况,支持投屏及摄像头同时投屏
- 支持按比例调整窗口大小
- 按原视频比例,等比伸缩
- 拉动窗口,进行自由伸缩
- 根据高度/宽度,自动调整窗口至视频比例
- 支持虚拟摄像头
- 命令行启动 mysc-t-vc 帮助文档
- 随时开启,随时关闭,随时切换设备
- 支持OBS虚拟摄像头/Unity Capture(windows)/v4l2loopback
音频
- 支持opus/flac/raw
- 支持切换声音输出设备,可配合VB-Cables模拟麦克风输入
控制
- 优化鼠标控制器
- 支持手势切换功能空间 手势:DR
- 支持插件配置注入
- 支持独占模式
- 新增键盘切换器
- 使用 F12 切换 UHID/ADB/Ctrl模式, F11 切换 控制空间
- 支持插件配置注入
- 按键映射创建工具(TPEditor),支持键盘,鼠标等多种控制映射方式,Windows/Linux 适用
- 支持UHID鼠标,可以实现Android界面中鼠标与PC混用
- 支持UHID-Keyboard,模拟外接键盘,直接输入中文(百度、搜狗输入法测试通过)
- 支持设备锁屏及黑屏下,通过InputPad输入密码解锁功能
- 支持鼠标滚轮滑动,缩放等功能
- 支持右键手势判断,快速回退、截屏、控制音乐播放
- 支持剪贴板
- 特殊场景下,支持ctrl调节鼠标移动速度功能
- 侧边栏多种功能键
帮助与支持
在使用中有任何问题、想法及建议,欢迎通过以下方式与我联系:
QQ群:579618095
基本使用
1.1 pypi直接安装使用(推荐)
pip install mysc[full]
pip install mysc
pip install mysc[flac]
pip install mysc[opus]
pip install mysc[gui]
pip install mysc[web]
pip install mysc[gui, opus, web]
mysc-cli
mysc-gui
1.2 克隆本项目至本地或下载release package, 使用pip安装所需包
pip install mysc-X.X.X.tar.gz
pip install loguru adbutils numpy av pyaudio
pip install pyperclip moosegesture dearpygui pygame pyvirtualcam
pip install nicegui
pip install pyflac
pip install pyogg opuslib
2. 项目结构:
- utils/
定义基本工具类及各类参数
- gui/dpg
DearPyGui 界面实现,包括视频绘制,鼠标事件,UHID鼠标、键盘输入,映射编辑等。
- gui/pg
pygame 界面实现,包括视频绘制、鼠标事件、键盘事件控制等。
- gui/ng
Nicegui Web UI (DEMO)
- core/*
Session、Connection、视频流、音频流、控制流、设备控制器等核心包
- extensions/
官方插件
- ~/.myscrcpy/*
本地化配置文件,包括运行类文件*.db 按键映射文件 tps/*.json
- tools/*
工具类,多用于生成CLI
3. 程序引用使用,便于自行开发
from adbutils import adb
from myscrcpy.core import *
from myscrcpy.utils import *
adb_device = adb.device_list()[0]
session = Session(
adb_device,
video_args=VideoArgs(max_size=1200),
audio_args=AudioArgs(),
control_args=ControlArgs()
)
frame = session.va.get_frame()
image = session.va.get_image()
session.ca.f_set_screen(True)
session.ca.f_touch_spr(
Action.DOWN,
ScalePointR(.5, .5, 0),
touch_id=0x0413
)
video_conn = VideoAdapter.raw_stream(adb_device, VideoArgs(max_size=1366, video_codec=VideoArgs.CODEC_H264))
while True:
video_raw_bytes = video_conn.recv(1024)
break
video_conn.disconnect()
audio_conn = AudioAdapter.raw_stream(adb_device, AudioArgs(audio_codec=AudioArgs.CODEC_OPUS))
while True:
audio_raw_bytes = audio_conn.recv(1024)
break
audio_conn.disconnect()
...
4.使用GUI
:exclamation: Ubuntu等Linux下 使用pyaudio 需要先安装portaudio
sudo apt install build-essential python3-dev ffmpeg libav-tools portaudio19-dev
运行DearPyGui GUI
mysc-cli
mysc-gui
python -m myscrcpy.run
运行Nicegui DEMO
python -m myscrcpy.gui.ng.main
程序截图
主界面
右键手势功能
Nicegui Web 界面(DEMO)
按键映射编辑器
插件管理器
所思所想
作为从 Scrcpy 1.X时代就开始使用的老玩家,感叹于Scrcpy的发展及神奇的功能的同时,也一直想做点什么。不过碍于有其他项目(懒)一直迟迟没有动手。
直到遇到了Scrcpy Mask 这一优秀项目,感觉我也要做点什么了。
遂于24年6月1日开始,阅读Scrcpy源码,使用python语言,借由pyav、adbutils、numpy、pyflac等优秀工具包,形成了MYScrcpy这一项目。
开发初期,是想解决在某些场景下,鼠标操作映射相关问题。随着不断开发,也产生许多涉及图形分析、AI接入(YOLO)、自动控制等方向的新想法。
MYScrcpy是MY(Mxx & ysY)系列的开始,接下来,将继续开发完善这一项目及相关应用。
目前项目为个人开发,时间、精力、水平有限,功能说明等文档方面会逐步完善。欢迎大家使用及指正。也可通过邮箱联系。如果后续有需要,也可以建群联系。
欢迎访问我的 Bilibili,之后会录制一些操作及讲解视频,希望大家喜欢。
最后十分感谢我的挚爱在开发中给予的支持。 :heart_eyes:
鸣谢
感谢 Scrcpy 项目及作者 rom1v,在这一优秀项目基础上,才有了本项目。
感谢使用到的各个包项目及作者们。有你们的付出,才有了如此好的软件开发环境。
同时感谢各位使用者们,谢谢你们的支持与帮助,也希望MYScrcpy成为你们得心应手的好工具,好帮手。
声明
本项目供日常学习(图形、声音、AI训练等)、Android测试、开发等使用。
请一定注意:
1.开启手机调试模式存在一定风险,可能会造成数据泄露等风险,使用前确保您了解并可以规避相关风险
2.本项目不可用于违法犯罪等使用
本人及本项目不对以上产生的相关后果负相关责任,请斟酌使用。
更新日志
- 1.7.0
- 支持Scrcpy 2.7
- 支持UHID Gamepad
- 升级支持 dearpygui 2.X
- 新增Unlocker工具
- 修复部分缺陷
- 1.6.6
- VirtualCam 新增范围选择及运行状态提示
- 修复部分缺陷
- 1.6.5
- 1.6.4
- 统一鼠标、键盘回调函数及传参
- 新增指定加载插件路径
- Capture 新增微调功能
- 1.6.3
- 1.6.2 VirtualCam 插件化
- 1.6.1 修复缺陷
- 1.6.0
- 接入uiautomator2
- 键盘控制器、鼠标控制器
- 日志管理器
- 修复窗口调整时跳动缺陷,DPG崩溃缺陷
- 全新插件体系,插件注入,插件管理器等
- 1.5.10 支持插件
- 1.5.9 新增文件管理器,支持设备文件管理,下载、上传及预览
- 1.5.8 支持文件/文件夹/截屏一键拷贝至设备
- 1.5.8 支持输出原始视频/音频流
- 1.5.7 CLI启动虚拟摄像头
- 1.5.5 优化Nicegui界面,方便termux使用
- 1.5.4 降低CPU占用
- 1.5.3 更新 Readme 文件
- 1.5.3 支持Opus音频解析
- 1.5.0 现已上线 pypi
- 1.4.2 使用moosegesture实现右键手势控制功能,支持模拟第二个点、画线后退、调整音量、播放媒体等功能
- 1.4.1 改用SQLite进行配置管理
- 1.4.0
- 久等了!全新Core/Session/Connection/Utils架构
- 新增窗口位置记忆功能,记录旋转前位置
- 支持心跳检测,自动断线重连
- 现已支持设备->PC 剪贴板
- 优化按键映射方式,Linux适用
- 更多控制按钮
- 1.3.6 新增网页端设备浏览页面DEMO(Nicegui),支持鼠标输入,UHID键盘输入、ADB输入及摇杆模拟鼠标输入
- 1.3.3 新增选择音频输出设备功能,可配合VB-Cables模拟麦克风输入
- 1.3.2 新增pyvirtualcam,支持OBS虚拟摄像头
- 支持连接配置保存,窗口大小保存
- 支持无线连接,历史连接记录及快速连接功能,告别繁琐命令行
- 支持按比例调整窗口大小、任意拉伸等功能
- 支持有线、无线连接安卓设备
- 支持断线重连,连接历史记录并自动尝试连接功能
- 支持 H265连接
- 实现了视频流解析(H264),生成numpy.ndarray,可自行使用opencv、image等进行图形处理
- 实现了音频流解析(FLAC), 使用 pyflac 解码,pyaudio 播放
- 实现了控制按键映射,鼠标映射
- 实现了UHID-Mouse与鼠标点击混用,可以实现Android界面中鼠标与PC混用模式
- 实现了UHID-Keyboard,支持模拟外接键盘,直接输入中文(搜狗输入法测试通过)
- 实现了DPG GUI下,鼠标滚轮缩放、滑动等功能
- 实现了设备锁屏下,通过InputPad输入密码解锁功能
- DPG GUI下设备翻转图像自动调整,无限制拉伸缩放等功能
- 实现了Ctrl调节鼠标移动速度功能
- 采用TwinWindow思路,解决DPG控件无法重叠问题,实现DPG控制映射编辑器(TPEditor)
- 纯Pygame控制模式下,最低延迟在6ms
开发计划
- APK管理器
- 使用范例及教程
- twisted / fastapi 接口
- YOLO 及 快速拉框导出等训练工具
- 视频、音频录制
- WebRTC