Getting started

Enigma gives you four ways to simulate movement on a paired iPhone: teleport to an exact point, follow a route, steer with a joystick, or replay a GPX track. Start with the desktop app, then add the compact ESP32-S3 controller if it fits your workflow.

What you need

• A Mac running macOS 12 or newer
• An iPhone you are authorized to test
• A USB cable for the initial Apple pairing
• A normal Wi-Fi network shared by the Mac and iPhone
• Optional: the supported Lichuang ESP32-S3 board for standalone control

Check compatibility for the currently qualified iOS and transport combinations before relying on Enigma for a test plan.

Start with the desktop app

1. Download the current macOS installer from GitHub Releases.
2. Connect and unlock the iPhone, approve Trust This Computer, and enable Developer Mode if the iOS build requires it.
3. Open Enigma, scan devices, and enable desktop Wi-Fi on the USB device entry.
4. Put the Mac and iPhone on the same LAN, disconnect USB, then scan and connect again.
5. Pick a point and test Set followed by Restore before running a route.

The desktop setup guide covers Mapbox search, local route storage, and recovery behavior in more detail.

Add the embedded controller

The Lichuang ESP32-S3 workflow is optional. The desktop provisions the board once over serial; the board then creates its own Wi-Fi network and controls the joined iPhone from its touch display. Follow embedded setup for firmware flashing, provisioning, and safe board transfer.

Before each test

• Confirm that Enigma shows the expected iPhone.
• Use only devices, apps, and services you are authorized to test.
• Keep the device unlocked for the first Set/Restore check.
• Restore real location before closing Enigma or installing an update.

If setup stalls, use the troubleshooting guide. See privacy for the exact local and network boundaries.