Everyday use
Troubleshooting connections and routes
Work through common Windows or macOS detection, Android or iPhone permission, wireless, and playback problems.
An Android phone is not detected
- 01
Confirm both apps are open
Open AlterGPS on Windows or macOS and the Android companion, then unlock the phone.
- 02
Replace the cable and port
Try the original data cable and a port directly on the computer. Use the same known-good combination for every later test.
- 03
Change the USB mode
Open the Android USB notification and choose File transfer or the requested data mode.
- 04
Review authorization
Approve the current USB debugging prompt. If it never appears, revoke old USB debugging authorizations in Developer options and reconnect.
- 05
Restart the chain
Close both apps, reconnect USB, then reopen the desktop app before the Android app if your release instructs you to do so.
Android permissions or settings are missing
- Open Developer options and confirm USB debugging is still enabled after the latest system update.
- Open Select mock location app and verify AlterGPS is selectable and selected when required.
- Allow the Android app to run in the background and remove it from aggressive battery-saving rules.
- Check that a work profile, family policy, or mobile-device-management policy has not blocked developer settings.
- Reinstall the current APK from the official source if the Android app opens with setup errors.
An iPhone is not detected
- 01
Unlock and reconnect
Unlock the iPhone, reconnect a data-capable cable directly to the computer, and keep the phone unlocked while it appears.
- 02
Inspect the trust prompt
If iOS asks whether to trust the computer, tap Trust and enter the passcode. If no prompt appears, disconnect and reconnect the cable before resetting trust.
- 03
Check Apple device support
On Windows, confirm the current Apple device support required by AlterGPS is installed. On macOS, approve any accessory or local-device permission shown by the system.
- 04
Review Developer Mode
If the supported iOS release requires Developer Mode, restart when instructed and enable it under Settings > Privacy & Security > Developer Mode.
The location resets or apps show the old position
- 01
Verify AlterGPS first
Confirm that the desktop app still shows the intended position and the device remains connected.
- 02
Keep both apps running
Do not force-stop the mobile companion or close the Windows or macOS app while the controlled position must remain active.
- 03
Refresh the affected app
Wait for that app location refresh interval. Reopen it only if the problem continues after AlterGPS shows a stable position.
- 04
Reset and reconnect
Stop the current action, return to the real position, reconnect USB, and repeat a single Place mode test.
Wireless mode drops
| Symptom | Likely check | Next step |
|---|---|---|
| Phone disappears after idle | Battery optimization or background limits | Allow AlterGPS to run in the background and test again. |
| Desktop sees no phone after network change | Computer and phone are no longer in the expected network/session | Reconnect USB and repeat the trusted pairing flow. |
| Connection works briefly, then stops | Unstable Wi-Fi, VPN, or sleep mode | Disable sleep during testing and avoid guest or captive networks. |
| Only one device stays online | Device-specific battery or network behavior | Reconnect each phone separately and compare its settings. |
A route follows the wrong path
- Stop playback before editing the trip.
- Zoom in and inspect every waypoint for a pin on the wrong side of a road or building.
- Change the travel profile and preview how the route timing and road choices change.
- Remove an unnecessary stop that causes a U-turn or loop.
- Reconnect the device if the map progress and mobile status disagree.
What to record before asking for help
Write down the AlterGPS versions on the desktop and mobile device, whether the desktop uses Windows or macOS, the phone model, its Android or iOS version, the exact step where setup stopped, any error message, the connection mode, and whether a single Place mode test succeeds. Do not include passwords or sensitive account information in screenshots.
Continue reading
Connect Android or iPhone to Windows or macOS
Complete the first USB pairing, resolve Android or iPhone authorization prompts, and confirm the mobile device is ready.
Set up cable-free control
Use AlterGPS without leaving the USB cable connected after completing the initial trusted pairing.
Use playback controls
Start, pause, resume, and stop a saved trip while monitoring connection and progress.
Still need help?
Use the troubleshooting guide first. If the issue remains, contact AlterGPS with the exact app versions, device model, and error text shown on screen.