RokidMirror Release Notes

This page records changes, stability improvements, and upgrade notes for the RokidMirror desktop tool. For installation and daily use, see Wireless Mirroring with RokidMirror.

1.1.6

Confirming real mirroring readiness

• The desktop still acknowledges ADB as soon as the target reaches device, while an optional mirroring-status acknowledgement prevents ADB readiness or brief scrcpy process survival from being reported as successful mirroring.
• RokidMirror marks a session as RUNNING only after the existing reliable scrcpy startup checks pass, and reports FAILED after a final startup failure.
• Standalone Mirror Scan 1.0.6 waits for the result when the desktop advertises this capability and exits only after receiving RUNNING for the same sessionId.
• New and old components remain interoperable. Older components ignore the optional fields, while QR, READY, ADB authorization, and the main mirroring flow remain compatible.

Session handling and Windows network recovery

• The desktop stores state by sessionId + target. Duplicate READY callbacks do not start a second scrcpy, and an already-running target returns its existing state.
• On Windows, a target must complete two consecutive real adb shell round trips after it appears as device before scrcpy starts. A bounded window allows the transport to stabilize after a Wi-Fi change.
• The Windows scrcpy readiness window is now 15 seconds. The one allowed recovery attempt must pass the transport check again.
• Recovery remains target-local: it never runs a global adb kill-server, removes other devices, or interrupts the shared ADB used by Android Studio, Codex, or terminals.

Release information

• Apple Silicon macOS, Intel macOS, and Windows x64 desktop packages are all version 1.1.6.
• The fallback standalone Mirror Scan APK is now 1.0.6 and can wait for true desktop mirroring readiness or display a clear failure.

1.1.5

Scan connection and ADB recovery

• Scan-to-mirror first reuses an ADB transport that can complete a real shell round trip.
• If the private ADB server does not form a device transport quickly, the session falls back to the shared ADB server without a full backoff cycle.
• A short circuit breaker avoids repeatedly selecting a private path that has failed on the current network.
• Bounded low-frequency recovery lets a target that appears slightly late finish ACK negotiation and start mirroring.
• Recovery remains target-local and never runs a global adb kill-server.

Multiple computers, devices, and sessions

• A bounded read-only authorization grace period helps when the same glasses are being moved between computers.
• Stopping a session releases its READY deduplication reservation so the same still-valid QR code can start it again.
• Duplicate callbacks remain strictly idempotent while scrcpy is starting or running.
• On exit, RokidMirror stops only the private ADB server it launched and leaves the shared development server untouched.
• Windows proxy and VPN checks are diagnostic only and no longer abort real bounded ADB attempts early.

Cross-platform experience

• macOS performs at most one non-interactive Keychain recovery per SSID during a run. Unreadable legacy entries fall back to the in-app password field instead of repeated system prompts.
• Windows simplifies firewall permission handling and no longer performs app-driven elevation or repeated supplemental authorization prompts.
• Windows improves high-DPI multi-device stop-button and status-text layout.
• macOS and Windows retain matching scan-to-mirror, manual connection, multi-device, audio, and media-export behavior.

Previous versions

Version	Main changes
1.1.5	Improved long-idle recovery, network switching, moving between computers, and Keychain credential restoration.
1.1.4	Fast fallback to shared ADB when macOS blocks only the private daemon; Windows follows the same fallback principle.
1.1.3	Isolated scan-to-mirror on a private ADB server while asynchronously preserving shared development ADB.
1.1.2	Improved offline recovery, Windows diagnostics, firewall guidance, and high-DPI text layout.
1.1.1	Added session ACK, cancellable authorization, and one target-local scrcpy recovery attempt.
1.1.0	Fixed media-export availability during mirroring and removed the low-frequency wireless-ADB-disable footer action.
1.0.8	Bounded retry for temporary routing failures and Wi-Fi roaming.
1.0.7	Improved macOS Local Network permission ordering and state detection.
1.0.6	Added macOS DMG distribution and improved callback and multi-device UI behavior.
1.0.5	Fixed macOS Local Network registration and long status messages.
1.0.4	Added macOS Local Network guidance and Settings shortcuts.
1.0.3	Improved network, shared ADB, scrcpy, and media-path diagnostics.
1.0.2	Added audio control, one-scan Wi-Fi mirroring, and strict callback validation.
1.0.1	Added QR-controlled wireless ADB, multi-device mirroring, and process deduplication.
1.0.0	Initial desktop release with bundled adb, scrcpy, device detection, and media export.

Upgrade recommendations

• Use RokidMirror 1.1.6 on macOS or Windows.
• Enterprise Glass3 users should prefer the built-in Scan app on a current system release.
• Use standalone Mirror Scan 1.0.6 only as a temporary fallback when the enterprise system cannot yet be upgraded, or for compatibility validation.
• Regenerate the QR code after upgrading the desktop tool.