AXe Mirror
Support
AXe Mirror lets you see and touch an iOS Simulator running on your Mac from an iPhone or iPad. It is a free companion app for the AXe command-line tool, and it is on the App Store.
What you need
- An Apple silicon Mac running macOS 14.5 or later, with AXe and Xcode's Simulator.
- An iPhone or iPad running iOS or iPadOS 17.5 or later, with the AXe Mirror app.
You can also try the app without a Mac. The Try the demo button connects to a demo simulator run by the AXe project.
Pair the app with your Mac
- On the Mac, run
axe mirror pair. It shows a QR code and a one-time code in the formXXXXX-XXXXX. - In AXe Mirror, scan the QR code or type the code. The code works once, and for ten minutes.
- On the Mac, run
axe mirror --udid <UDID>with the UDID of a booted simulator.axe list-simulatorsprints the UDIDs.
You pair once. After that, the app can connect whenever axe mirror is running. Press Ctrl+C on the Mac to stop.
Troubleshooting
- The code has expired. Run
axe mirror pairagain to get a new one. - The app says "not paired". Pair again, or run
axe mirror viewerson the Mac to check that your device is in the list. - The app cannot connect. Check that the Mac is awake and online, and that
axe mirroris running. - The picture is laggy on the same Wi-Fi. A wired network connection for the Mac helps.
Get help
If something does not work, open an issue on the AXe GitHub repository.
For every command and option, see the AXe Mirror documentation. For how the app handles your data, see the privacy policy.
