1. Home
  2. Guides
  3. Troubleshooting

Troubleshooting

Fix a missing device or failed location request

Start with the shared USB checklist, then follow the section for Windows, Mac, Developer Mode, routes, scripts, or restoring the real location.

Mac and WindowsUpdated September 3, 2026

Quick connection checklist

  1. Use a USB cable that supports data, not only charging.
  2. Connect directly to the computer when possible.
  3. Unlock the iPhone or iPad and accept Trust This Computer.
  4. Enable Settings → Privacy & Security → Developer Mode.
  5. Close extra copies of Wormhole or Device Manager.
  6. Open Wormhole, choose Refresh, and select the intended device.

Windows: the device is not listed

  1. Install or open Apple Devices.
  2. Confirm the device is visible in Apple Devices. If it is not, reconnect the cable and repeat the Trust prompt.
  3. Close and reopen Wormhole as a normal user, then choose Refresh.
  4. If the bundled CLI stopped unexpectedly, close Wormhole completely and reopen it so the child process can restart.

Wormhole does not require Run as administrator. Elevating one process can create a different session and does not repair a USB driver problem.

Mac: Device Manager is not available

  1. Install the current package from the official Manager page.
  2. Open Device Manager from Applications and confirm its menu bar item appears.
  3. Keep only one installed copy. Quit and remove older development or download-folder copies.
  4. Open the Mac App Store app again and refresh the device list.

Unexpected privacy prompt: the official Device Manager does not need broad access to other apps' data. If macOS asks for that access, choose Don't Allow, remove any older development copy, reinstall version 2.1.0 from this site, and contact support if the prompt returns.

Developer Mode is off or hidden

  1. Connect and unlock the device.
  2. Attempt the first location operation in Wormhole so it can reveal the Developer Mode setting when possible.
  3. Open Settings → Privacy & Security → Developer Mode.
  4. Enable it and complete any restart and confirmation prompts on the device.
  5. Reconnect, refresh, and try Set Location again.

Set Location fails

  • Confirm the correct device is selected and connected by USB rather than Wi-Fi.
  • Keep the device unlocked during the first request.
  • Check latitude and longitude ranges and use a period as the decimal separator.
  • Stop any route or script before starting a different location operation.

Route calculation or playback fails

  • Set both the start and destination before calculating.
  • Keep both points inside the current country; cross-country automatic routes are unsupported.
  • Move the endpoint farther away if the route is reported as too short.
  • Calculate again after loading a favorite route.
  • If playback stops, confirm the USB connection and start again from a newly calculated route.

A script reports an error or will not stop

  • Call MoveTo(latitude, longitude) before relative movement.
  • Check function spelling, brackets, quotes, and finite numeric arguments.
  • Use Stop to cancel a long-running loop or movement sequence.
  • If the page was closed, return to the script project and start a new run.

See the complete Wormhole Script reference for APIs and sandbox limits.

Restore does not complete

  1. Stop the current route or script.
  2. Reconnect and unlock the device if the USB connection was interrupted.
  3. Refresh the device list and select the device again.
  4. Return to Location and choose Restore.
  5. Wait for the success message before disconnecting.

Contact support

If the problem remains, email psychangstudio@gmail.com with the computer OS version, Wormhole version, iPhone or iPad model, iOS/iPadOS version, exact error text, and the step that failed. Do not send device passcodes, purchase credentials, or other secrets.