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

  1. On the Mac, run axe mirror pair. It shows a QR code and a one-time code in the form XXXXX-XXXXX.
  2. In AXe Mirror, scan the QR code or type the code. The code works once, and for ten minutes.
  3. On the Mac, run axe mirror --udid <UDID> with the UDID of a booted simulator. axe list-simulators prints 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 pair again to get a new one.
  • The app says "not paired". Pair again, or run axe mirror viewers on 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 mirror is 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.