Repository navigation
Releases: kinewe/scrcpy-ez
Release list
scrcpy-ez 2.4.1
scrcpy-ez 2.4.1 — 应用读取与投屏流畅度优化
本版包含最新的设置分类，以及自动平滑的 1 帧／2 帧缓冲上限选择。基于 scrcpy 5.0.1，提供 Windows x64 发行包。
更新内容
- 应用搜索与大列表扩展：应用数量保护上限由 500 提高至 10,000，面向安装上千应用的设备扩展读取能力。支持按应用名、包名、拼音全拼／首字母／混拼／部分前缀搜索（既有搜索能力保留）；本版优化大列表分批显示、可见区域图标加载和后台刷新，减少读取进度更新对搜索结果与滚动位置的干扰。
- 动态读取与图标优化：根据应用数量、有线／无线连接及已观察到的处理耗时动态安排读取超时；列表与图标分阶段处理，图标仍在读取时即可使用已取得的列表，部分图标失败时保留可用列表并支持重试。图标缓存与可见区域优先加载减少重复工作；读取状态移至应用窗口底部并淡出，通知界面不再显示无关的应用读取提示。
- 设备识别兼容：补充 USB／无线调试切换、发现和配对异常的处理，保留正常识别路径。
- 设备原生规格：读取设备支持的分辨率和刷新率上限，按设备生成档位和重置值；无线投屏默认 60fps，保留原生高刷选项。应用窗口自动 DPI 随尺寸调整。
- 高帧率供帧：修正编码器工作帧率提示，避免高刷输入仍按固定 60 的工作提示配置；设备不接受时可兼容回退。
- ABR 按实际积压介入：区分源端、链路和接收端解码压力，取消复杂帧和微小短趋势单独触发的降档，解除码率与帧率的强制联动；恢复带退避，单项锁和双锁继续有效。
- 应用窗口真实限帧：动态降帧实际减少输入帧，窗口拉伸和编码器重建后保留限制。
- 主投屏亮屏锁：替代周期性模拟活动，只在主投屏期间按设置持有；退出或失联后释放，应用投屏不申请主投屏亮屏锁。
- 设置分类与自动平滑：设置按“窗口与显示／设备与应用／画面体验”分组，平滑在底部。开启后可选 1 帧或 2 帧缓冲上限，默认关闭，旧配置默认沿用 2 帧预算；修改后重新投屏生效。
自动平滑依据编码流节奏自动调整等待，最多 32ms；1 帧偏低延迟，2 帧多一些缓冲余量，不是固定等待，也不补帧。刷新率设置仍是上限，实际输出取决于内容、设备、电脑和连接。
下载与升级
下载 scrcpy-ez-2.4.1.zip 与 SHA256SUMS.txt，校验后解压运行 scrcpy-ez.exe。推荐使用应用内更新。手动更新请先退出 EZ 与投屏并备份原目录，保留自己的 profiles.json、settings.json、root 偏好和图标缓存。
发行包仅含空设备档案，不含个人设置、设备记录、通知内容、测试应用或诊断脚本。包内 FILE_SHA256SUMS.txt 可校验每个文件，SOURCE_MANIFEST.json 记录源码和运行库来源。请整包更新 GUI、启动脚本、客户端、server 和 DLL，不与候选版混用；本版配套协议为 5.0.1-ez2.4.1-release。
验证与边界
最新功能代码通过 C 完整 20 项、Java 定向 53 项、Go 应用／桥接模块完整回归与 22 个前端测试文件；设置链路覆盖开关×帧数×有线／无线×主投屏／应用投屏 16 种组合。
此前同实现候选构建在 Windows 11、K80、Xiaomi Pad 8 Pro 和老华为上验证了适用的主投屏、应用读取及图标流程；包括软／硬解码、受控解码／链路过载、恢复和应用窗口拉伸。正式版另行重建与校验版本和配套文件，不把版本提升称为重新完成全部设备性能实测。
没有物理屏摄或光学端到端延迟测量，不保证所有场景都能达到设置上限或消除全部卡顿。Android／ROM／应用兼容性、网络和主机负载仍会影响效果；Android 10 以下保留原有 ABR 兼容旁路。
scrcpy-ez 2.4.0 | scrcpy 5.0.1 与应用投屏体验升级
scrcpy-ez 2.4.0 — scrcpy 5.0.1 与应用投屏体验升级
本版已升级至 scrcpy 5.0.1，客户端与 Android 服务端配套协议为 5.0.1-ez2.4.0，并更新 FFmpeg 9.0.2 / SDL 3.4.18。默认使用硬件解码，保留图片剪贴板、自适应帧率与码率、通知同步、多设备和应用投屏。
推荐主动提高投屏规格
升级后请打开设备卡片的“规格面板”，按手机、电脑和连接条件主动选择更高的长边分辨率、帧率与码率。参数按设备和有线／无线连接分别保存；已有自定义参数会继续保留，需要自行调整。
版本特性
- 投屏内核升级：scrcpy 5.0.1 的硬件解码与新视频缓冲，兼容规格徽标和动态尺寸，保留 ez 图片编解码能力
- 通知点击跳转到投屏：普通通知可以在应用投屏中打开对应详情；每台设备可在“应用通知 → 通知选项”开关该功能，默认开启，验证码通知仍只复制验证码
- 通知与窗口体验：改善高清通知图标缩放、通知会话恢复与连续微信消息横幅；默认按设备自然方向创建通知窗口，微信采用原生布局兼容策略
- 应用页面复用与保护：优先复用兼容的后台应用页面；手机正在使用目标应用或页面布局不兼容时先提示，只有确认“关闭并投屏”才重新打开应用。关闭保留内容的应用窗口时，尽量把任务归还手机后台
- 设置更清晰：通知跳转与内容选项标明“当前设备”，验证码复制期限标明“所有设备”；自定义参数胶囊及更新下载进度显示更一致
- 无需运行时 PowerShell：投屏进程信息改为直接调用 Windows COM/WMI，窗口前置校验进程创建时间，处理多设备、应用包名、复杂参数、查询超时和连续点击；关闭投屏继续由原生事件监督器管理所属进程
更新、下载与校验
下载 ZIP 与同页的 SHA256SUMS.txt，校验后解压并运行 scrcpy-ez.exe。推荐使用应用内更新；手动更新前先退出 ez 与投屏并备份原目录，保留自己的 profiles.json、settings.json、root 偏好及图标缓存。全新安装包只包含空设备档案，不含个人设置、设备记录、通知内容或诊断日志。
GUI、投屏支持脚本、客户端、server 和 DLL 必须整包配套更新。scrcpy-server-legacy 仅为历史备份，不能与当前客户端混用；回退请恢复完整旧包。包内 FILE_SHA256SUMS.txt 提供逐文件校验。
验证与兼容范围
Windows GUI 使用 Windows 子系统构建。完整 Go 回归、并发竞争检测、静态检查，以及 32／64 位原生 WMI 枚举回归通过；C、Android Java 和网页回归及三端 Release 构建通过。内核升级阶段已在 Windows 11、REDMI K80 / Android 16 验证 H.264／H.265、硬件与软件解码、应用虚拟屏和通知链路，后续微信通知方向、窗口关闭后手机状态及应用前台保护有用户实测记录。
不同 APP 的通知详情跳转和后台页面复用仍受 Android／ROM／应用兼容性影响，部分布局需要确认后重新打开应用；不承诺所有通知均可进入精确详情。其他品牌、旧 Android、root、多设备及 USB 插拔未在本次发布新增逐项实机验证；本次原生窗口前置和安全软件提示未新增实机验收。
scrcpy-ez 2.3.0 | 手机通知、主投屏保活与 root 权限修复
scrcpy-ez 2.3.0
本版将手机通知、验证码复制与可选 root 权限修复加入统一运行包，并提供主投屏保活及手机电源键快捷键，无需在手机安装 APP
新增与改进
- 手机已配对且 ADB 在线时即可接收新通知，无需开启投屏；支持全局开关、按设备和应用管理、批量修改、仅验证码模式、消息预览及验证码复制期限
- 通知使用来源应用图标，验证码可点击正文或按钮复制；改进 Windows 通知注册、程序迁移、复制动作和断线恢复
- 小米系统短信在锁屏时若仍提供独立验证码字段，ez 可显示并复制号码；若正文和号码均不可读，只显示系统提供的摘要，仅验证码模式会跳过无法识别号码的通知
- 默认开启全局“主投屏期间手机不自动休眠”，统一适用于所有设备的有线、无线主投屏；修改后重新主投屏生效，结束主投屏后恢复空闲休眠，应用投屏不启用保活
- Ctrl+P 短按手机电源键，主投屏和应用投屏窗口均可锁屏或唤醒；保持按键不会触发长按，Ctrl+H 黑屏省电及原有快捷键继续可用
- 普通与 root 设备使用同一安装包；已 root 手机可在规格面板启用“上传权限失败时自动 root 修复”，权限故障后等待 Shell 的 su 授权，针对服务端目录和文件修复，随后仍以普通 Shell 启动服务
- 已入档设备的 mDNS 地址稳定后后台补连，通知监听随真实连接恢复；已连接设备电量自动刷新，通知空白名单可关闭同步，通知设置退出时保存
下载与更新
Windows 64 位完整包为 scrcpy-ez-2.3.0.zip，完整解压后运行 scrcpy-ez.exe，辅助脚本为 投屏支持.bat
现有用户可应用内更新；手动更新请先退出并备份，保留原 profiles.json、settings.json、root 偏好及图标缓存，不用包内空档案覆盖原档案。GUI、客户端、服务端和支持脚本应整包配套更新
附件含 ZIP 和 SHA256SUMS.txt；包内提供逐文件 FILE_SHA256SUMS.txt 与 SOURCE_MANIFEST.json，不含个人配置、设备记录或调试截图
验证范围
Windows GUI、C 客户端与 Android 服务端发布构建通过；Go 的 12 个包、18 份前端测试、真实 C 输入处理器的电源快捷键回归、16 项 Android 通知单元测试及 Windows 原生通知注册、复制、撤回、程序迁移回归通过
发布包校验空设备档案、ZIP CRC 和逐文件哈希；上传后下载两端附件核对 SHA256。GUI 与客户端文件属性统一为 2.3.0，GUI 使用 Windows 子系统且无预发布标记
此前相同功能代码已在 REDMI K80 / Android 16 验证主投屏保活、手动电源休眠、仅剩应用投屏时恢复休眠及锁屏短信验证码。通知可读内容依赖系统与来源应用，其他品牌及 root 手机修复尚未实机验证
Android Release 构建及 lintVitalRelease 通过；完整 lintRelease 尚有通知代码中的 13 项已知错误（API 等级和通知权限检查），本版未将完整 lint 计作通过。投屏线协议保持 4.1-ez2.2.2
scrcpy-ez v2.2.2
本版改进 USB 插拔、多设备投屏、应用投屏兼容和剪贴板稳定性
- USB 插拔采用事件驱动，不再依赖 2 秒检测轮询，设备卡片与投屏会话同步切换有线和无线
- 修复批量启动漏启和设备卡片延迟更新，完善设备档案身份、无线地址及应用图标缓存
- 修复小米、REDMI、POCO 多开应用投屏影响实体屏手势和组件尺寸的问题，其他品牌可使用「应用投屏显示导航栏和桌面」兼容开关
- 多个主投屏和应用投屏共享剪贴板事务，修复图片反复复制和 Windows 无法粘贴，关闭全部投屏后仍可粘贴最后收到的图片
- 统一 UHID/SDK 显示，设置说明改为通俗文字
- 应用列表与图标查询自动匹配随包服务端版本，修复从 2.2.1 升级后应用列表无法读取、图标无法加载的问题
- 修复投屏期间设备改名光标约一秒后消失和输入中断，刷新时保留光标、选区和正在输入的文字
- 修复成功更新后红点和完成提示重复出现，成功提示只保留首次运行，后续发现新版本仍正常提醒
适用于 Windows 64 位，下载 scrcpy-ez-2.2.2.zip 并完整解压后运行 scrcpy-ez.exe
应用内更新会保留原设备档案和设置，手动更新前请备份，已有用户不要用包内空 profiles.json 覆盖原档案，客户端与服务端应整包更新
REDMI K80 与 Xiaomi Pad 8 Pro 已通过多窗口、窗口缩放、参数重投、USB 拔插、批量启动以及图片和文本双向复制实测，投屏期间设备改名也已实测通过，其他品牌尚无真机验证
附件包括 Windows 完整运行包和 SHA256 校验文件
本页的 2.2.2 运行包已重新打包并包含投屏期间设备改名、应用列表、图标查询和更新提示修复，已安装此前 2.2.2 的用户请手动重新下载并更新，同版本不会触发应用内升级
root 用户尝试包（额外附件）
2026-10-03 追加：scrcpy-ez-2.2.2-root.zip，内部产品版本为 v2.2.2-root.2。窗口和界面保持 scrcpy-ez 2.2.2 原版外观，通过版本号区分。
- 普通设备投屏已由用户确认通过，root 设备仍未验证。 这是针对服务端 JAR 上传权限问题的修复尝试，不保证解决具体 ROM 或 root 模块异常。
- 保留原客户端与服务端配对；上传失败时尝试诊断和修复目录／文件标签及权限。手机 Shell root 授权最多等待 3 分钟，总流程最多 5 分钟，停止或断线可取消。
- 请单独完整解压 root 包，不覆盖正式版。正式版自动更新入口在此尝试版中停用；包内包含使用说明、调研、验证记录和组件哈希清单。
- 配套校验文件：
scrcpy-ez-2.2.2-root.sha256.txt。root ZIP SHA-256：a68f284859b10dd5a39209b647b663171d86be7086a1960f799c1d27f0e2ea1a。 - root 源码：ez root-experimental-v2.2.2。对应提交：72203e0e0dece0d4bb10eff099050872111495b4。
原 scrcpy-ez-2.2.2.zip、SHA256SUMS.txt 和 v2.2.2 标签保持不变。此页默认的 Source code ZIP／tar.gz 仍为正式版源码；root 源码请使用上面的独立分支。
scrcpy-ez v2.2.1
scrcpy-ez v2.2.0
scrcpy-ez v2.2.0
新增
- 应用窗口：手机应用变成电脑上的独立窗口——多开 / 窗口跟随 / 界面密度 / 每应用独立参数记忆
- 音视频编码可选：H.264 / H.265 / AV1 / VP8 / VP9 × Opus / AAC / FLAC / RAW（每设备、每应用独立记忆）
- 编码 / 声音行「重置」按钮；刷新率、码率可锁定不被自适应调整
修复与改进
- 旧版 adb 服务占用导致的配对 / 启动「操作失败」问题
- 多来源日志、启动读取序、界面细节等一批稳定性改进
scrcpy-ez v2.1.0
scrcpy-ez v2.1.0
新增
- 设备端「正在投屏」通知：投屏期间手机/平板显示常驻通知，点按通知即可直接从设备停止投屏；通知右侧显示品牌图标，投屏结束后自动撤下
- 新增「设置」面板：可调整参数控件默认显示开关；允许关闭窗口时最小化到托盘（投屏不中断）
优化
- 资源消耗优化：接收缓冲改为按需分配，降低每路投屏的内存占用
其他
- 同步 v2.0 以来的全部修复：GUI 退出体验（窗口立即消失、后台收尾）、托盘修复、设备发现与配对流程改进等
- 包内 README 已更新至 v2.1.0
scrcpy-ez v2.0
scrcpy-ez v2.0
全新 GUI 图形界面版！设备卡片自动发现、多设备并行投屏、批量管理、无线调试扫码/配对码配对、有线/无线规格独立自定义、TLS 加密标识、GUI 退出零残留。
下载
- Windows 11 x64：下方 scrcpy-ez-2.0.zip（解压即用，绿色免安装）
快速开始
- 解压后双击 scrcpy-ez.exe
- 手机打开开发者模式 → USB 调试（小米需再开「USB 调试（安全设置）」）
- 插线授权配对，或点「从『无线调试』配对新设备」扫码配对
- 点设备卡片「投屏」即可；拔线自动切无线
详见 README（中英双语）。
scrcpy-ez v1.0.1
v1.0.1 更新内容
- Ctrl+T 窗口置顶开关：一键将投屏窗口置顶（类似微信置顶），再按一次取消
- 置顶状态发光指示灯：参数控件左侧新增指示灯（置顶时亮橙灯，未置顶灰点）；按住 Alt 点击指示灯也可切换置顶
- README 中英同步更新（含指示灯控件示意图）
资产
- scrcpy-ez-1.0.1.zip：完整发布包（含 投屏启动.bat / scrcpy.exe / server / legacy server）
scrcpy-ez — 轻松易用的安卓投屏增强版
scrcpy-ez
基于 scrcpy 4.1 的增强版投屏工具——即开即投，无需折腾。
特性
- 打字友好（Android 13+ UHID 直输中文）
- 图片剪贴板（电脑复制 → 手机粘贴，PR #6676）
- 自适应帧率/码率（操作/无操作双阈值，跟手不锁码率）
- TSF 空文档屏蔽（输入法不抢键，切回应用保持中文）
- 快捷键 Ctrl+F/G/H + Alt+F
说明
- 本项目由 AI 全程开发
- 仅在 Windows 11 测试
- 解压即用（含全部运行库）