Windows setup
Install the app, verify Apple device drivers, enable Developer Mode, and make the first USB connection.
Set up Windows →Official documentation
Set up Wormhole and use every location mode
Start with the guide for your computer, then learn single-point location, route simulation, JavaScript automation, and the fastest way to diagnose a connection problem.
Start here
Choose your computer
Both platforms control the same iPhone and iPad features, but their initial connection setup is different.
Mac setup
Install the Mac App Store app and Wormhole Device Manager, then connect your device over USB.
Set up Mac →Troubleshooting
Fix missing devices, Developer Mode prompts, route errors, script errors, and restore problems.
Diagnose a problem →Feature guides
From one location to a repeatable scenario
Set and restore a location
Apply an exact point, make small joystick adjustments, save a favorite, and return to the real location.
Read the location guide →Simulate a route
Select both endpoints, calculate the path, choose a pace, run the route, and stop safely.
Read the route guide →Automate with Wormhole Script
Use standard JavaScript and the six sandboxed location functions to build a reusable movement sequence.
Read the script guide →Connection checklist
Four requirements shared by every feature
- Use an iPhone or iPad running a supported iOS/iPadOS version.
- Enable Developer Mode in Settings → Privacy & Security.
- Connect with a USB data cable, unlock the device, and accept the Trust prompt.
- Select the correct device in Wormhole before setting, moving, or restoring the location.
Route limitation: automatic route calculation only supports start and destination points within the current country. This does not affect single-point location.