Skip to content

Latest commit

 

History

History
72 lines (60 loc) · 3.68 KB

SUPPORT.md

File metadata and controls

72 lines (60 loc) · 3.68 KB

Support

iPhoneMirror is a community-maintained public preview. Use the latest published release or main build when reproducing a problem, and include the exact version from About. Source-tree test versions and published releases may differ.

中文用户可先阅读教程的常见问题。反馈时请说明具体安装版本、 连接方式、操作步骤及失败时间;可直接填写下方模板,设备标识和日志请先脱敏。

Before requesting help

  1. Use the latest release and read the README troubleshooting and driver notes.
  2. Unlock the iPhone, reconnect it and confirm “Trust This Computer”.
  3. For USB capture, open Driver manager from the main window and run the one-click repair or installation flow.
  4. For AirPlay, connect the computer and iPhone to the same private network; wireless sources do not require the USB capture driver. An administrator Setup creates a process-scoped local-subnet AirPlay firewall rule; portable users must allow the WirelessHost process's dynamic TCP/UDP media ports manually if necessary.
  5. For video-app casting or recording/streaming failures, confirm that the release contains tools/ffmpeg/ffmpeg.exe and include the output status and timestamp in the report. The virtual camera requires Windows 11 and a one-time administrator installation.
  6. For USB/wireless reverse control, check Developer Mode, the DDI/HID status and device binding in the user guide. Include the bridge error code; a media-stream 9021 response alone does not establish HID compatibility. Keep iUsbBridge.exe, _internal, and its runtime manifest together. Bluetooth control has separate BLE/AssistiveTouch requirements.

Report Windows version, ProductType, iOS version, connection type, AirPlay backend (original/UxPlay), reproduction steps, expected/actual behavior, and the relevant timestamp. Start from the documentation index for topic-specific guidance.

Attach the relevant files from %LOCALAPPDATA%\iPhoneMirror\Logs and, for driver issues, %LOCALAPPDATA%\iPhoneMirror.Driver\Logs\driver-ui.log. Redact UDIDs, device names, user paths, account data and screen content before uploading.

For reproducible bugs, use the repository's Bug Report form. For feature ideas, use the Feature Request form.

Security vulnerabilities must be reported privately through GitHub Security Advisories.

Reproduction details / 问题反馈模板

Copy this template into the Bug Report form. Leave unknown values as unknown. For a local build, include its commit and whether the working tree has extra changes.

App version / 软件版本(About / 关于):
Package / 安装方式: Setup / ZIP / local build
Windows version and architecture / 系统版本与架构:
Device ProductType and iOS / 设备型号标识与 iOS:
Connection / 连接方式: USB / AirPlay
Receiver backend / 无线接收方案(如适用): original / UxPlay
Control transport / 反控方式(如适用): Bluetooth / USB / wireless
Steps / 复现步骤:
1.
2.
Expected result / 预期结果:
Actual result and error code / 实际结果与错误码:
Failure time and time zone / 失败时间与时区:
Frequency / 复现频率:
Sanitized logs or screenshots / 已脱敏日志或截图:

Do not include the API key, control session token, UDID, pairing files or private screen content. Logs around the failure time are usually more useful than a full unfiltered log history. Use the private security reporting link above for vulnerabilities.