Repository navigation
Releases
Mirra v0.1.3
Mirra 0.1.3 improves bridge validation, support recovery and diagnostics for Apple's iPhone Mirroring on Intel-based Macs.
Mirra uses a separate jailbroken iPhone as a bridge. The iPhone you mirror does not need a jailbreak.
Highlights
- Require a fresh iPhone Mirroring launch after background recovery replaces sharingd, with a clear Command-Q instruction before reconnecting.
- Preserve bridge setup, native keystore and transport failures in diagnostics, including timeouts, EOF and exited helpers.
- Validate attested keys, native signatures, session handles and protocol boundaries before reporting success.
- Add optional graphics, Bluetooth, Wi-Fi, AWDL and SIP observations, and distinguish decoder creation from delivered video.
- Clarify compatibility limits and provide a self-signed app package.
Installation and compatibility
Download Mirra-v0.1.3.dmg, verify SHA256SUMS, quit Mirra and iPhone Mirroring, and drag Mirra.app into Applications. Open Mirra and choose Update and connect when offered for an existing setup.
Requires an Intel-based Mac running macOS 15 or later with compatible private interfaces, working AWDL and H.264 decoding, and a jailbroken bridge iPhone running iOS 15 or later with OpenSSH and ldid. Use disabled or compatible partially enabled SIP. Fully enabled SIP and RootHide are unsupported. See Compatibility.
Validation and signing
Passed 402 Python regressions, 282 native UI checks and the native bridge, graphics, media, recovery and authorization checks. These checks do not establish compatibility with every device or OS build. Mirra remains experimental.
The app is self-signed, without Apple Developer ID signing or notarization. Gatekeeper warnings can still appear; self-signing does not guarantee approval carries over after updates.
Includes the earlier keystore and OCLP contributions from @OiviaDesu. Original source and artwork use the MIT License; bundled components retain their upstream licenses.
Mirra v0.1.2
Mirra 0.1.2 improves OCLP compatibility, iOS 15 keystore discovery and startup recovery for Apple's iPhone Mirroring on Intel-based Macs.
Mirra uses a separate jailbroken iPhone as a bridge. The iPhone you mirror does not need a jailbreak.
Highlights
- Correct the OCLP RemoteScreen export lookup, contributed by @OiviaDesu in PR #5.
- Extend guarded missing-keystore-symbol discovery across iOS 15 builds, retaining exported-symbol priority and the verified build-specific fallback.
- Recover abandoned support registrations after runtime removal while preserving saved setup and ownership checks.
- Wait for an already-open iPhone Mirroring app to quit, then continue startup automatically.
Installation and compatibility
Download Mirra-v0.1.2.dmg, verify SHA256SUMS, quit Mirra and iPhone Mirroring, and drag Mirra.app into Applications. Choose Update and connect when offered for an existing setup.
Requires Intel x86_64, macOS 15 or later with compatible private interfaces, working AWDL and H.264 decoding, and a jailbroken bridge iPhone running iOS 15 or later with OpenSSH and ldid. Fully enabled SIP and RootHide are unsupported. Sequoia connections remain experimental.
Validation and credits
Passed 348 Python regressions, 280 native UI checks and native compatibility checks. The contributor reported a successful local OCLP retest; broader iOS 15 and recovery configurations still need device validation. See the changelog.
Thanks to @OiviaDesu for the keystore and OCLP work in PR #4 and PR #5. Co-author credit is retained in the adapted commits.
This package is ad-hoc signed and not notarized. Mirra remains experimental. Original source and artwork use the MIT License; bundled components retain their upstream licenses.
Mirra v0.1.1
Mirra 0.1.1 improves bridge compatibility, support recovery, and decoder handling for Apple’s iPhone Mirroring on Hackintosh.
Mirra prepares a separate jailbroken iPhone as a bridge. The iPhone you mirror does not need a jailbreak.
Highlights
- Fix default rootless helper placement inside the jailbreak bootstrap, while preserving custom deployments and RootHide support.
- Integrate a guarded iOS 15.8.8 keystore fallback into the existing endpoint and repair the recognized OCLP RemoteScreen constant stub.
- Improve automatic Display P3/FLS decoder handling on Intel build
25G332and keep bridge support available while AVConference is idle or restarting. - Recover unfinished support sessions before updating, preserve the saved bridge setup, and pause failed startup attempts to prevent repeated permission prompts.
- Improve SSH connection diagnostics and failed-update error reporting.
- Add experimental macOS Sequoia support when the required private interfaces match.
Installation
- Download
Mirra-v0.1.1.dmgand verify it againstSHA256SUMS. - Quit iPhone Mirroring and Mirra. Open the DMG and drag Mirra.app into Applications, replacing the previous app.
- Eject the DMG and open Mirra.
- For an existing bridge setup, choose Update and connect when offered. For a new setup, follow the bridge setup instructions.
Compatibility
Intel (x86_64), macOS 15 or later, and compatible private framework interfaces are required. The tested reference remains macOS 26.7.2 (25G332) with Apple’s iPhone Mirroring 1.6 (98.5). Sequoia connection support is experimental.
The bridge must be a jailbroken iPhone running iOS 15 or later, with OpenSSH and ldid installed. Working AWDL and H.264 VideoToolbox decoding are required. The guarded iOS 15.8.8 fallback applies only to the documented build and image UUIDs; it does not establish general iOS 15 compatibility.
Credits and validation
Thanks to @OiviaDesu for the reports, investigation, and fixes in PR #4. The keystore fallback and OCLP repair were adapted and refactored into Mirra’s existing code, with co-author credit retained.
The source passed 317 Python tests and the native media, keystore, symbol-loader, compatibility, decoder, and certificate checks. These checks do not replace device validation. The contributor’s successful OCLP connection report concerns his original PR build; the integrated fallback still needs validation on that bridge.
Experimental status
Mirra is an independent community project and is not affiliated with Apple. Compatibility and performance depend on the configuration, and software updates may break functionality.
The app uses the same ad-hoc signing approach as v0.1.0 and is not notarized.
License
Mirra’s original source and artwork use the MIT License. Bundled and external components retain their own licenses.
Mirra v0.1.0
First public release of Mirra, a native macOS companion for Apple's iPhone Mirroring on Hackintosh.
Mirra prepares a separate jailbroken iPhone as a bridge. The iPhone you mirror does not need a jailbreak.
Highlights
- Guided setup over Wi-Fi SSH or USB, with SSH identity verification and certificate preparation.
- Rootless and RootHide bridge deployment support.
- Background service with connection recovery and media/decoder compatibility support.
- Compact native interface with appearance settings and optional live logs.
- Dated log files, automatic seven-day cleanup, and an Open log folder action.
- DMG installation with Python and the required helpers included.
Installation
- Download
Mirra-v0.1.0.dmgand verify it againstSHA256SUMS. - Open the DMG and drag Mirra.app into Applications.
- Eject the DMG, open Mirra, and follow bridge setup.
Compatibility
This release targets Intel (x86_64) hosts running macOS 26.7.2 (25G332) with iPhone Mirroring 1.6 (98.5). A compatible jailbroken bridge with OpenSSH and ldid, working AWDL, and H.264 VideoToolbox decoding are required.
See Compatibility for the full requirements.
Experimental status
Mirra is an independent community project and is not affiliated with Apple. It provides a best-effort compatibility workaround and does not recreate a complete T2 chip or provide equivalent hardware security guarantees.
Compatibility, performance, and display quality depend on your configuration. Mirra may not work on your devices, and software updates may break functionality.
The app is ad-hoc signed and is not notarized.
License
Mirra's original source and artwork use the MIT License. Bundled and external components retain their own licenses.