A Scrcpy client implemented in Python. Gui with Kivy/dearpygui/pygame. With Video, Audio, also Control. GUI Supports Key Proxy, Extensions, window position record, right-click gesture control, File Manager, Virtual Camera, UHID Keyboard and Chinese input and more.
包含完整的视频、音频、控制解析，开发友好，引入即用！
现代化界面风格，支持Windows/Ubuntu(X11)/MacOSX，支持多设备连接，鼠标及键盘映射。
V1.7.0 采用 DearPyGui 作为主要GUI。 支持编写插件，窗口位置记忆、右键手势控制、断线重连、文件管理器、虚拟摄像头投屏、中文输入，锁屏密码解锁等功能。
高速模式使用pygame作为鼠标及键盘控制映射GUI。提供鼠标隐藏、按键事件监听等功能， 适用于第一人称相关应用的按键映射。
V3.2.1 主界面
pip install mysc[full]Session(adb_device, video_args=VideoArgs(1200)).va.get_image()在使用中有任何问题、想法及建议，欢迎通过以下方式与我联系：
注意 V3.2.X以上 采用KivyMD 2.X版本 需手动安装
# 完整安装
pip install mysc[full]
# NOT myscrcpy... my-scrcpy already exists in pypi...
# V3.2.0 采用 KivyMD 2.X 版本，需手动安装
pip install https://github.com/kivymd/KivyMD/archive/master.zip
# 仅核心
pip install mysc
# 支持flac
pip install mysc[flac]
# 支持opus
pip install mysc[opus]
# 若使用界面 则：
pip install mysc[gui]
# 若使用web demo 则：
pip install mysc[web]
# 可按需组合，例如
pip install mysc[gui, opus, web]
#安装完成后
# Gui 及 日志 console
# V3.2.0 Kivy
mysc-k-cli
# 无Console
# V3.2.0 Kivy
mysc-k
pip install mysc-X.X.X.tar.gz
pip install loguru adbutils==2.7.2 numpy av pyaudio
# GUI
pip install kivy>=2.3.1
pip install https://github.com/kivymd/KivyMD/archive/master.zip
pip install pyperclip moosegesture pynput
# Web GUI
pip install nicegui
# 使用flac
pip install pyflac
# 使用opus
pip install pyogg opuslib
# 1.4.X 新 Core/Session 架构，推荐使用
from adbutils import adb
from myscrcpy.core import *
from myscrcpy.utils import *
# Connect to Scrcpy
# Create a Session
adb_device = adb.device_list()[0]
# 或者使用 myscrcpy提供的高级设备管理工厂创建
# DeviceFactory.load_devices()
# adv_device = DeviceFactory.device_list()[0]
# adb_device = adb_device.adb_dev
session = Session(
adb_device,
video_args=VideoArgs(max_size=1200),
audio_args=AudioArgs(),
control_args=ControlArgs()
)
# Get RGB Frame np.ndarray
frame = session.va.get_frame()
# Get PIL.Image
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
)
# 1.5.8 NEW
# 获取原始视频流/音频流
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)
# Your Code Here
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)
# Your Code Here
break
audio_conn.disconnect()
...
:exclamation: Ubuntu等Linux下 使用pyaudio 需要先安装portaudio
sudo apt install build-essential python3-dev ffmpeg libav-tools portaudio19-dev
mysc-k-cli # With Log Console
mysc-k # Only GUI
python -m myscrcpy.gui.ng.main
2025-05-10 V3.2.0 近期喜得小宝，更新的进度慢了许多。感谢大家的理解与支持。转眼50+星了，你们的支持和鼓励是我继续下去的动力！再次谢谢大家！
作为从 Scrcpy 1.X时代就开始使用的老玩家，感叹于Scrcpy的发展及神奇的功能的同时，也一直想做点什么。不过碍于有其他项目（懒）一直迟迟没有动手。
直到遇到了Scrcpy Mask 这一优秀项目，感觉我也要做点什么了。
遂于24年6月1日开始，阅读Scrcpy源码，使用python语言，借由pyav、adbutils、numpy、pyflac等优秀工具包，形成了MYScrcpy这一项目。
开发初期，是想解决在某些场景下，鼠标操作映射相关问题。随着不断开发，也产生许多涉及图形分析、AI接入（YOLO）、自动控制等方向的新想法。
MYScrcpy是MY（Mxx & ysY）系列的开始，接下来，将继续开发完善这一项目及相关应用。
目前项目为个人开发，时间、精力、水平有限，功能说明等文档方面会逐步完善。欢迎大家使用及指正。也可通过邮箱联系。如果后续有需要，也可以建群联系。
欢迎访问我的 Bilibili，之后会录制一些操作及讲解视频，希望大家喜欢。
最后十分感谢我的挚爱YSY在开发中给予的支持。 :heart_eyes:
感谢 Scrcpy 项目及作者 rom1v，在这一优秀项目基础上，才有了本项目。
感谢 Kivy/KivyMD Dearpygui Pygame等优秀GUI框架
感谢使用到的各个包项目及作者们。有你们的付出，才有了如此好的软件开发环境。
同时感谢各位使用者们，谢谢你们的支持与帮助，也希望MYScrcpy成为你们得心应手的好工具，好帮手。
本项目供日常学习（图形、声音、AI训练等）、Android测试、开发等使用。
请一定注意：
1.开启手机调试模式存在一定风险，可能会造成数据泄露等风险，使用前确保您了解并可以规避相关风险
2.本项目不可用于违法犯罪等使用
本人及本项目不对以上产生的相关后果负相关责任，请斟酌使用。
FAQs
A Scrcpy client implemented in Python. Gui with Kivy/dearpygui/pygame. With Video, Audio, also Control. GUI Supports Key Proxy, Extensions, window position record, right-click gesture control, File Manager, Virtual Camera, UHID Keyboard and Chinese input and more.
We found that mysc demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
The EU Cyber Resilience Act is prompting compliance requests that open source maintainers may not be obligated or equipped to handle.
Security News
Crates.io adds Trusted Publishing support, enabling secure GitHub Actions-based crate releases without long-lived API tokens.
Research
/Security News
Undocumented protestware found in 28 npm packages disrupts UI for Russian-language users visiting Russian and Belarusian domains.