0xCodez/iphone-mirror-windows

项目介绍

iPhone Mirror 把 Windows 10/11 电脑变成 AirPlay 接收端，在无边框、圆角、默认置顶的 iPhone 形状窗口中显示手机画面，支持横屏旋转窗口和一键保存 PNG 截图。镜像阶段手机无需装 App，也不需要连线。可选的控制功能通过 USB 借助 WebDriverAgent 发送点按、长按、滑动、滚动、输入、Home、App Switcher 和音量操作，由 pymobiledevice3 负责启动。适合想在 Windows 上获得类似 macOS「iPhone 镜像」窗口、并愿意为输入控制多做配置的用户。

快速使用

1. 安装 Python 3.11 或更新版本，安装时勾选「Add python.exe to PATH」。确保 iPhone 和电脑连接同一 Wi-Fi。
2. 下载仓库 ZIP 或克隆到一个固定目录，双击 install.bat。脚本会检查 Python 版本，在 %LOCALAPPDATA%\iPhoneMirror\venv 创建独立虚拟环境、安装 requirements.txt 依赖，并在桌面和开始菜单创建快捷方式。
3. 启动 iPhone Mirror，窗口显示「Waiting for iPhone」和电脑地址。首次启动时允许 Python 通过 Windows Defender 防火墙的专用网络，并将当前 Wi-Fi 设置为「专用」网络。
4. 在 iPhone 打开控制中心 > 屏幕镜像，选择电脑名称。窗口显示「Connecting...」后即可看到手机画面。

USB 控制需要单独准备：连接并信任 iPhone，运行 control.bat reveal-dev-mode，在手机上打开开发者模式并重启，运行 control.bat get-wda，用 Sideloadly 签名安装 WebDriverAgentRunner.ipa，信任开发者描述文件，运行 control.bat doctor 直到全部检查通过，再按 Ctrl + U 或点击手形按钮。完整步骤见 USB 控制一节。

使用约束

• 仅支持 Windows 10/11，需要 Python 3.11+；应用需从仓库目录运行，移动目录后要重新执行 install.bat。
• DRM 保护的内容（如 Netflix、Apple TV）会显示黑屏，这是 iPhone 端限制；默认请求 1080 像素高的画面，可在 settings.json 中调整。
• 控制功能需要数据线、开发者模式、来自 apple.com 的 iTunes（提供 Apple USB 驱动服务）以及侧载的 WebDriverAgent。免费 Apple ID 的签名 7 天后失效，需重新安装；iOS 17.0–17.3 上开启控制需要管理员权限。
• 控制延迟约 100–200 ms，单击会等待约 0.2 s 以区分双击；滑动只在松开鼠标时发送，因此不能边拖边看画面跟随。
• 项目以 GPL-3.0 发布，FairPlay 模块移植自同样采用 GPL-3.0 的 playfair 代码。

配置与实现

主要配置项（name、画面 width/height、fps、audio、always_on_top）位于 %LOCALAPPDATA%\iPhoneMirror\settings.json。发现阶段通过 mDNS 广播 _airplay._tcp 和 _raop._tcp；TCP 7000 上的 asyncio RTSP 服务处理配对和 FairPlay；H.264 视频与 AAC-ELD 音频由 PyAV 解密解码；窗口使用 PySide6 构建。没有 iPhone 时，可用 python -m iphone_mirror --local 配合 python tools/fake_iphone.py 127.0.0.1 7100 运行完整的模拟会话，tests/test_fairplay.py 和 tests/test_wda.py 覆盖 FairPlay 与控制客户端。

HotRepo 点评

iPhone Mirror 是一套有实际协议实现的工具，而不是简单封装：README 说明了 AirPlay 配对、FairPlay 密钥解包、音视频管线和用于测试的模拟 iPhone，项目布局也把每类协议关注点对应到具体模块。HotRepo 唯一记录的榜单快照显示，它在 2026-11-09 进入 Python 新项目榜，自 2026-11-08 创建以来新增 101 Star 和 17 Fork。这次观察只能说明项目上线初期获得了关注，无法据此判断趋势，目前也还没有 GitHub 全部语言日榜名次记录。对使用者而言，主要门槛在 USB 控制的一整套配置，而不在镜像本身。