GPS JoyStick Guide - The App Ninjas

Unlock Features
Setup
Automation
Troubleshooting

Get the unlocked version of the app for free!

To further aid your app testing, we have provided an unlocked version for experimentation and academic purposes for free! No need to pay for the same features available elsewhere!
Privacy Mode - allows you to generate a complete clone of the app with a randomized name!

System Mode - uses system privileges to mock location.

Suspended Mocking - broadcasts a mock location for a short period of time and then suspends broadcasting so that your test app can pick up the last known location.

Indirect Mocking - prevents your test app from detecing mock location being enabled in developer settings on older versions of Android.

A-GPS Reset - prevents your test app from jumping to the real location.

Fix Options - up to 4 options that can be mixed and matched to prevent your test app from jumping to the real location.

Download Unlocked Version

Select the best version dependent on your device.
You're detected device:

Most common:
gpsjoystick-unlocked-arm64-v8a.apk
gpsjoystick-unlocked-armeabi-v7a.apk

Less common:
gpsjoystick-unlocked-x86_64.apk
gpsjoystick-unlocked-x86.apk

Legacy Unlocked Version (v4.3.5)

Select the best version dependent on your device.
You're detected device:

Most common:
gpsjoystick-unlocked-arm64-v8a.apk
gpsjoystick-unlocked-armeabi-v7a.apk

Less common:
gpsjoystick-unlocked-armeabi.apk
gpsjoystick-unlocked-mips.apk
gpsjoystick-unlocked-x86_64.apk
gpsjoystick-unlocked-x86.apk

Setup
Prerequisites

By default this app will allow you test and mock location on most generic apps.

However there are some apps that detect mock location. To successfully mock location and test those apps, there is additional setup required which can be get tricky and your results can vary.

Steps

1. First download and install the unlocked version for your device.

2. Choose an option you are most comfortable with and then continue with the appropriate steps for it.
Options

Over the years it has become tougher and tougher to test apps that detect mock location and thus the steps required to properly set up this app have become more difficult and/or limited by your Android version.

Depending on your technical level and risk tolerance, you have 3 main options:
Smali Method - Use a smali patch to hide mock locations from all apps on your device.

Root Method - Root your device and make GPS JoyStick a system level app so that it can have access to the gps directly.

No Root Method - Attempt to bypass mock locations by downgrading your Google Play Services or the Android Security Patch (this option heavily depends on some factors of your Android version).
Smali Method

Some users may find this approach as being the most reliable and least prone to rubberbanding/random jumping. Use this method at your own risk, we are not responsible for any issues you may encounter.

Here are some links if you want to learn more:

Magisk
Reddit - Video Smali Tutorial
Reddit - Root Smali Tutorial
Russian - Smali Tutorial
Root Method

Do not root your phone unless you are aware and understand that some apps will not let you use them until you un-root your phone (or do a system-less root). Root at your own risk!

Here are some links if you want to learn more:

Android Rooting
Make GPS JoyStick A System App
Magisk
Reddit - Android 8.1 - Magisk joystick guide (without paid apps)
Reddit - Systemizing GPS Joystick by App Ninjas using TWRP

Rooted Users

The following steps are for devices that have already been rooted (either by one of the guides above or another method)

1. If your device has already been rooted then use an app like Link2SD, Lucky Patcher or Magisk to move GPS JoyStick to "/system/app" or if that location doesn't work then: "/system/priv-app".

2. Once GPS JoyStick has been moved to "/system/app" or "/system/priv-app" unroot your phone (so that the app you are trying to test on doesn't detect root)

3. Enable System Mode in GPS JoyStick Settings screen.

Additional Steps for Android Oreo (8.0) Users And Above

Try these steps if it is still not working after following one of the guides above:

1. Put GPS Joystick in "root/system_root/system/priv-app" and make sure file permissions are set to 0644

2. Create a text file called "privapp-permissions-com.theappninjas.fakegpsjoystick.xml" and paste this into it:
<privapp-permissions package="com.theappninjas.fakegpsjoystick"> <permission name="android.permission.INTERNET"/> <permission name="android.permission.ACCESS_NETWORK_STATE"/> <permission name="android.permission.ACCESS_COARSE_LOCATION"/> <permission name="android.permission.ACCESS_FINE_LOCATION"/> <permission name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS"/> <permission name="android.permission.ACCESS_MOCK_LOCATION"/> <permission name="android.permission.SYSTEM_ALERT_WINDOW"/> <permission name="android.permission.INSTALL_LOCATION_PROVIDER"/> <permission name="android.permission.WRITE_SETTINGS"/> <permission name="android.permission.WRITE_SECURE_SETTINGS"/> <permission name="android.permission.CHANGE_COMPONENT_ENABLED_STATE"/> <permission name="com.google.android.providers.gsf.permission.READ_GSERVICES"/> <permission name="com.android.vending.BILLING"/> <permission name="android.permission.WAKE_LOCK"/> <permission name="com.google.android.c2dm.permission.RECEIVE"/> <permission name="com.theappninjas.fakegpsjoystick.permission.C2D_MESSAGE"/> </privapp-permissions>
3. Place the file at "root/system_root/system/etc/permissions/" and make sure permissions are set to 0644

4. Edit the file "root/system_root/system/etc/permissions/privapp-permissions-xxx.xml" (where xxx represents your device name)

5. Add the same XML from Step 2 between the <permissions></permissions> tags and make sure permissions are set to 064

6. Restart the device and confirm that the Enable System Mode is enabled in GPS JoyStick Settings
No Root Method

It is unlikely you will be able to use this method unless you have an older Android device which has not been updated. However if you do have an older Android device, then these steps may work for you and will not require root.

Depending on your security patch date you will have to follow different steps. Here’s how you can find out your phone’s security patch: https://www.guidingtech.com/65197/check-android-security-patch/

Android 6.0 And Above + Security Patch AFTER March 5, 2017

1. You need to check your Google Play Services app version and ensure that it is 12.6.85 or lower. If it is then skip to step 6, otherwise continue with the next step.

2. First we need to Disable Play Store auto-updates, to do this, open the Google Play Store app. Touch the hamburger icon in the top-left, swipe up and choose Settings. Then under General, tap Auto-update apps and choose the first option: Do not auto-update apps.

3. Now you need to download the older version of Google Play Services that is the closest match for your phone from here: https://www.apkmirror.com/apk/google-inc/google-play-services/google-play-services-12-6-85-release/

4. Now we need to disable Find My Device under Settings — Security & Location. Also disable Google Play Services in the same way. Next remove updates to the application by going to Settings — Applications — All — Google Play Services — Uninstall updates. You may need to go to Settings — Device Administrators — and disable Android Device Manager first.

5. Install the downloaded version of Google Play Services from step 3 and restart the phone.

6. Now you can go to Developer Options and set GPS JoyStick as the Mock Locations app.

7. Enable Suspended Mocking option in the GPS JoyStick Settings screen.

Android 6.0 And Above + Security Patch BEFORE March 5, 2017

1. Go to Developer Options and set GPS JoyStick as the Mock Locations app.

2. Enable Indirect Mocking option in the GPS JoyStick Settings screen.

Automation
Tasker

We now have Tasker support with teleporting to a location, starting a route, walking to waypoints, or stopping the joystick!
Teleport

1. Create a new task and add an Action - Misc - Send Intent

2. Set Action to theappninjas.gpsjoystick.TELEPORT

3. Enter Extra: lat: {your-latitude-value} ex. lat: 37.8095

4. Enter Extra: lng: {your-longitude-value} ex. lng: -122.4101

5. (Optional) Enter Extra: alt: {your-altitude-value} ex. alt: 10.4

6. Set Target to Service

Route

1. Create a new task and add an Action - Misc - Send Intent

2. Set Action to theappninjas.gpsjoystick.ROUTE

3. Enter Extra: name: {your-route-name}

4. Set Target to Service

Stop

1. Create a new task and add an Action - Misc - Send Intent

2. Set Action to theappninjas.gpsjoystick.STOP

3. Set Target to Service

Pro Intents

The following intents require a Pro subscription. Setup is the same: create a new task, add Send Intent, set Target to Service.

Walk

1. Create a new task and add an Action - Misc - Send Intent

2. Set Action to theappninjas.gpsjoystick.WALK

3. Enter Extra: waypoints: {lat,lng;lat,lng;...} ex. waypoints: 37.8095,-122.4101;37.8060,-122.4090

4. (Optional) Enter Extra: teleport: true to teleport to the first waypoint before walking

5. (Optional) Enter Extra: speed: {speed-in-km/h} to set the walking speed, ex. speed: 15.0

6. Set Target to Service

Pause Route

1. Create a new task and add an Action - Misc - Send Intent

2. Set Action to theappninjas.gpsjoystick.ROUTE_PAUSE

3. Set Target to Service

Resume Route

1. Create a new task and add an Action - Misc - Send Intent

2. Set Action to theappninjas.gpsjoystick.ROUTE_RESUME

3. Set Target to Service

Next Waypoint

1. Create a new task and add an Action - Misc - Send Intent

2. Set Action to theappninjas.gpsjoystick.ROUTE_NEXT

3. Set Target to Service

Previous Waypoint

1. Create a new task and add an Action - Misc - Send Intent

2. Set Action to theappninjas.gpsjoystick.ROUTE_PREV

3. Set Target to Service

Hide Joystick

1. Create a new task and add an Action - Misc - Send Intent

2. Set Action to theappninjas.gpsjoystick.HIDE

3. Set Target to Service

Show Joystick

1. Create a new task and add an Action - Misc - Send Intent

2. Set Action to theappninjas.gpsjoystick.SHOW

3. Set Target to Service

Set Speed

1. Create a new task and add an Action - Misc - Send Intent

2. Set Action to theappninjas.gpsjoystick.SPEED

3. Enter Extra: speed: {speed-in-km/h} ex. speed: 25.0 (must be greater than 0)

4. Set Target to Service

Teleport to Favorite

1. Create a new task and add an Action - Misc - Send Intent

2. Set Action to theappninjas.gpsjoystick.FAVORITES

3. Enter Extra: name: {your-favorite-name} ex. name: Home

4. Set Target to Service

Start Recording Route

1. Create a new task and add an Action - Misc - Send Intent

2. Set Action to theappninjas.gpsjoystick.RECORD_START

3. Set Target to Service

Begins recording a route from the current position. The joystick must be running.

Add Waypoint to Recording

1. Create a new task and add an Action - Misc - Send Intent

2. Set Action to theappninjas.gpsjoystick.RECORD_ADD

3. Set Target to Service

Adds the current position as a waypoint to the active recording.

Stop Recording Route

1. Create a new task and add an Action - Misc - Send Intent

2. Set Action to theappninjas.gpsjoystick.RECORD_STOP

3. Enter Extra: name: {route-name} ex. name: My Recorded Route (optional — omit to cancel without saving)

4. Set Target to Service

Stops recording. If name is provided, saves the route (requires at least 2 recorded points) and broadcasts theappninjas.gpsjoystick.RECORD_SAVED on success with extras name and point_count. If name is omitted, the recording is cancelled and discarded.

Generate Route

1. Create a new task and add an Action - Misc - Send Intent

2. Set Action to theappninjas.gpsjoystick.GENERATE

3. (Optional) Enter Extra: mode: {0 or 1} — 0 = random (default), 1 = circle

4. (Optional) Enter Extra: marker_count: {number} — number of waypoints, 1–5000 (default 10)

5. (Optional) Enter Extra: offset: {meters} — distance between points in meters (default 50.0)

6. Set Target to Service

Generates a route from the current position and starts walking it immediately.

Query Status

1. Create a new task and add an Action - Misc - Send Intent

2. Set Action to theappninjas.gpsjoystick.STATUS

3. Set Target to Service

Queries the current runtime state. The app broadcasts theappninjas.gpsjoystick.STATUS_RESPONSE with extras: lat (double), lng (double), alt (double), speed (double), bearing (double), is_route_active (boolean), is_route_paused (boolean), route_remaining (int), route_total (int), route_mode (string: "stop", "loop", or "reverse"), is_reversed (boolean), is_running (boolean), is_hidden (boolean), is_recording (boolean), record_count (int). Works even when the joystick is idle.

Receiving Broadcasts

Some intents broadcast a response back (e.g. STATUS sends STATUS_RESPONSE). All intents broadcast theappninjas.gpsjoystick.ERROR on failure. To receive these in Tasker:

Receiving STATUS_RESPONSE

1. Create a new Profile and select Event

2. Choose System → Intent Received

3. Set Action to theappninjas.gpsjoystick.STATUS_RESPONSE

4. Link a Task — extras are available as %lat, %lng, %alt, %speed, %bearing, %is_route_active, %is_route_paused, %route_remaining, %route_total, %route_mode, %is_reversed, %is_running, %is_hidden, %is_recording, %record_count

Receiving Errors

1. Create a new Profile and select Event

2. Choose System → Intent Received

3. Set Action to theappninjas.gpsjoystick.ERROR

4. Link a Task — extras are available as %source_action (the intent that failed), %error (error code), and %message (description)

Common error codes: PRO_REQUIRED, SERVICE_NOT_RUNNING, INVALID_EXTRAS, FAVORITE_NOT_FOUND, NOT_RECORDING, INVALID_WAYPOINTS, SAVE_FAILED
ADB Shell

We now have ADB Shell support with teleporting to a location, starting a route, walking to waypoints, or stopping the joystick!
Teleport

Android Oreo & above (altitude is optional):
adb shell am start-foreground-service -a theappninjas.gpsjoystick.TELEPORT --ef lat {your-latitude-value} --ef lng {your-longitude-value} --ef alt {your-altitude-value}

Older Android versions (altitude is optional):
adb shell am startservice -a theappninjas.gpsjoystick.TELEPORT --ef lat {your-latitude-value} --ef lng {your-longitude-value} --ef alt {your-altitude-value}

Route

Android Oreo & above:
adb shell am start-foreground-service -a theappninjas.gpsjoystick.ROUTE --es name \"{your-route-name}\"

Older Android versions:
adb shell am startservice -a theappninjas.gpsjoystick.ROUTE --es name \"{your-route-name}\"

Stop

Android Oreo & above:
adb shell am start-foreground-service -a theappninjas.gpsjoystick.STOP

Older Android versions:
adb shell am startservice -a theappninjas.gpsjoystick.STOP

Examples

adb shell am start-foreground-service -a theappninjas.gpsjoystick.TELEPORT --ef lat 37.8095 --ef lng -122.4101

adb shell am startservice -a theappninjas.gpsjoystick.TELEPORT --ef lat 37.8095 --ef lng -122.4101 --ef alt 10.2

adb shell am start-foreground-service -a theappninjas.gpsjoystick.ROUTE --es name \"My Awesome Route\"

adb shell am startservice -a theappninjas.gpsjoystick.STOP

Pro Intents

The following intents require a Pro subscription. All examples use the Android Oreo+ syntax (start-foreground-service). For older Android versions, replace with startservice.

Walk

Android Oreo & above (teleport and speed are optional):
adb shell am start-foreground-service -a theappninjas.gpsjoystick.WALK --es waypoints "{lat,lng;lat,lng;...}" --ez teleport {true|false} --ef speed {speed-in-km/h}

Older Android versions (teleport and speed are optional):
adb shell am startservice -a theappninjas.gpsjoystick.WALK --es waypoints "{lat,lng;lat,lng;...}" --ez teleport {true|false} --ef speed {speed-in-km/h}

Pause Route

Android Oreo & above:
adb shell am start-foreground-service -a theappninjas.gpsjoystick.ROUTE_PAUSE

Older Android versions:
adb shell am startservice -a theappninjas.gpsjoystick.ROUTE_PAUSE

Resume Route

Android Oreo & above:
adb shell am start-foreground-service -a theappninjas.gpsjoystick.ROUTE_RESUME

Older Android versions:
adb shell am startservice -a theappninjas.gpsjoystick.ROUTE_RESUME

Next Waypoint

Android Oreo & above:
adb shell am start-foreground-service -a theappninjas.gpsjoystick.ROUTE_NEXT

Older Android versions:
adb shell am startservice -a theappninjas.gpsjoystick.ROUTE_NEXT

Previous Waypoint

Android Oreo & above:
adb shell am start-foreground-service -a theappninjas.gpsjoystick.ROUTE_PREV

Older Android versions:
adb shell am startservice -a theappninjas.gpsjoystick.ROUTE_PREV

Hide Joystick

Android Oreo & above:
adb shell am start-foreground-service -a theappninjas.gpsjoystick.HIDE

Older Android versions:
adb shell am startservice -a theappninjas.gpsjoystick.HIDE

Show Joystick

Android Oreo & above:
adb shell am start-foreground-service -a theappninjas.gpsjoystick.SHOW

Older Android versions:
adb shell am startservice -a theappninjas.gpsjoystick.SHOW

Set Speed

Android Oreo & above:
adb shell am start-foreground-service -a theappninjas.gpsjoystick.SPEED --ef speed {speed-in-km/h}

Older Android versions:
adb shell am startservice -a theappninjas.gpsjoystick.SPEED --ef speed {speed-in-km/h}

Teleport to Favorite

Android Oreo & above:
adb shell am start-foreground-service -a theappninjas.gpsjoystick.FAVORITES --es name "{your-favorite-name}"

Older Android versions:
adb shell am startservice -a theappninjas.gpsjoystick.FAVORITES --es name "{your-favorite-name}"

Start Recording Route

Android Oreo & above:
adb shell am start-foreground-service -a theappninjas.gpsjoystick.RECORD_START

Older Android versions:
adb shell am startservice -a theappninjas.gpsjoystick.RECORD_START

Add Waypoint to Recording

Android Oreo & above:
adb shell am start-foreground-service -a theappninjas.gpsjoystick.RECORD_ADD

Older Android versions:
adb shell am startservice -a theappninjas.gpsjoystick.RECORD_ADD

Stop Recording Route (name is optional — omit to cancel without saving)

Android Oreo & above:
adb shell am start-foreground-service -a theappninjas.gpsjoystick.RECORD_STOP --es name "{route-name}"

Older Android versions:
adb shell am startservice -a theappninjas.gpsjoystick.RECORD_STOP --es name "{route-name}"

Generate Route (mode, marker_count, and offset are optional)

Android Oreo & above:
adb shell am start-foreground-service -a theappninjas.gpsjoystick.GENERATE --ei mode {0|1} --ei marker_count {count} --ed offset {meters}

Older Android versions:
adb shell am startservice -a theappninjas.gpsjoystick.GENERATE --ei mode {0|1} --ei marker_count {count} --ed offset {meters}

Query Status — no extras required, responds even when idle

Android Oreo & above:
adb shell am start-foreground-service -a theappninjas.gpsjoystick.STATUS

Older Android versions:
adb shell am startservice -a theappninjas.gpsjoystick.STATUS

The app broadcasts theappninjas.gpsjoystick.STATUS_RESPONSE with 15 extras: lat, lng, alt, speed, bearing, is_route_active, is_route_paused, route_remaining, route_total, route_mode (string: "stop", "loop", or "reverse"), is_reversed, is_running, is_hidden, is_recording, record_count.

Receiving Broadcasts

ADB can send intents but cannot directly listen for broadcast responses. To verify broadcasts during development, use logcat in a separate terminal:

adb logcat -s BroadcastQueue:I | grep -E "STATUS_RESPONSE|gpsjoystick.ERROR"

For programmatic broadcast receiving, register a BroadcastReceiver in your app at runtime:

registerReceiver(receiver, new IntentFilter("theappninjas.gpsjoystick.STATUS_RESPONSE"), Context.RECEIVER_EXPORTED);

The RECEIVER_EXPORTED flag is required on Android 13+ (API 33) since the broadcast comes from a different app.

Error broadcasts use action theappninjas.gpsjoystick.ERROR with extras: source_action (the intent that failed), error (error code), and message (description).

Pro Examples

adb shell am start-foreground-service -a theappninjas.gpsjoystick.WALK --es waypoints "37.8095,-122.4101;37.8060,-122.4090"

adb shell am start-foreground-service -a theappninjas.gpsjoystick.WALK --es waypoints "37.8095,-122.4101;37.8060,-122.4090" --ez teleport true

adb shell am start-foreground-service -a theappninjas.gpsjoystick.ROUTE_PAUSE

adb shell am start-foreground-service -a theappninjas.gpsjoystick.ROUTE_RESUME

adb shell am start-foreground-service -a theappninjas.gpsjoystick.ROUTE_NEXT

adb shell am start-foreground-service -a theappninjas.gpsjoystick.ROUTE_PREV

adb shell am start-foreground-service -a theappninjas.gpsjoystick.HIDE

adb shell am start-foreground-service -a theappninjas.gpsjoystick.SHOW

adb shell am start-foreground-service -a theappninjas.gpsjoystick.SPEED --ef speed 25.0

adb shell am start-foreground-service -a theappninjas.gpsjoystick.FAVORITES --es name "Home"

adb shell am start-foreground-service -a theappninjas.gpsjoystick.RECORD_START

adb shell am start-foreground-service -a theappninjas.gpsjoystick.RECORD_ADD

adb shell am start-foreground-service -a theappninjas.gpsjoystick.RECORD_STOP --es name "My Recorded Route"

adb shell am start-foreground-service -a theappninjas.gpsjoystick.GENERATE --ei mode 0 --ei marker_count 20 --ed offset 100.0

adb shell am start-foreground-service -a theappninjas.gpsjoystick.STATUS
Deep Links

GPS JoyStick supports gpsjoystick:// deep links for triggering actions from browsers, other apps, or automation tools. Tap a deep link or open it programmatically to launch the app and execute the corresponding action. If the joystick overlay is already running, the action executes immediately. If not, the app starts and sets up the action.

Teleport — teleport to a specific location

gpsjoystick://teleport?lat={latitude}&lng={longitude}&alt={altitude}

The alt parameter is optional.

Route — start a saved route by name

gpsjoystick://route?name={your-route-name}

Stop — stop the joystick

gpsjoystick://stop

Examples

gpsjoystick://teleport?lat=37.8095&lng=-122.4101

gpsjoystick://teleport?lat=37.8095&lng=-122.4101&alt=10.2

gpsjoystick://route?name=My%20Awesome%20Route

gpsjoystick://stop

Pro Deep Links

The following deep links require a Pro subscription.

Walk — walk along a series of waypoints

gpsjoystick://walk?waypoints={lat,lng;lat,lng;...}&teleport={true|false}&speed={speed-in-km/h}

The teleport and speed parameters are optional. Teleport defaults to false. When true, teleports to the first waypoint before walking. Speed sets the walking speed in km/h.

Pause Route — pause a walking route

gpsjoystick://route-pause

Resume Route — resume a paused route

gpsjoystick://route-resume

Next Waypoint — skip to the next waypoint on the active route

gpsjoystick://route-next

Previous Waypoint — jump back to the previous waypoint

gpsjoystick://route-prev

Hide Joystick — hide the joystick overlay

gpsjoystick://hide

Show Joystick — show the joystick overlay

gpsjoystick://show

Set Speed — change the movement speed (must be greater than 0)

gpsjoystick://speed?speed={speed-in-km/h}

Teleport to Favorite — teleport to a saved favorite location by name

gpsjoystick://favorites?name={your-favorite-name}

Start Recording Route — begin recording a route from the current position

gpsjoystick://record-start

Add Waypoint to Recording — add the current position to the active recording

gpsjoystick://record-add

Stop Recording Route — stop recording and save the route (requires at least 2 points). Omit name to cancel without saving.

gpsjoystick://record-stop?name={route-name}

Generate Route — generate a random or circular route from the current position and start walking it

gpsjoystick://generate?mode={0|1}&marker_count={count}&offset={meters}

All parameters are optional. mode: 0 = random (default), 1 = circle. marker_count: 1–5000 (default 10). offset: distance in meters (default 50).

Pro Examples

gpsjoystick://walk?waypoints=37.8095,-122.4101;37.8060,-122.4090

gpsjoystick://walk?waypoints=37.8095,-122.4101;37.8060,-122.4090&teleport=true

gpsjoystick://route-pause

gpsjoystick://route-resume

gpsjoystick://route-next

gpsjoystick://route-prev

gpsjoystick://hide

gpsjoystick://show

gpsjoystick://speed?speed=25.0

gpsjoystick://favorites?name=Home

gpsjoystick://record-start

gpsjoystick://record-stop?name=My%20Recorded%20Route

gpsjoystick://generate?mode=0&marker_count=20&offset=100

Troubleshooting
How to enable Developer Options/Mock Locations?

First you must enable Developer Options. To do this you must find the Build number for your specific device (if your device is not listed here you may have to search on Google to find the specific steps).
Google Pixel: Settings > System > About phone > Build number

Samsung Galaxy S8 and later: Settings > About phone > Software information > Build number

LG G6 and later: Settings > About phone > Software info > Build number

HTC U11 and later: Settings > About > Software information > More > Build number

OnePlus 5T and later: Settings > About phone > Build number

Once you’ve found Build number, you'll need to tap on it seven times. After a few taps, you'll see a small pop-up alert telling you that "You are now X steps away from being a developer" with a number that counts down with every additional tap. After the seventh tap, a message will appear telling you that "You are now a developer!" and the Developer options will be unlocked as an option in Settings or Settings > System.

Finally navigate to Developer options and find the Mock Locations setting. If you are on Android version 4.4, simply enable the Mock Locations setting. If you are on Android version 5.0 and above, tap on Mock Locations / Set mock location app and select the GPS JoyStick app.
Why does "Failed to detect location. (12)" or "GPS signal not found." error occur?

For the test app you see this error, it occurs when that app is able to detect that you are mocking your location. The only way to prevent this is to Setup this app properly (as mentioned above) so it won't be detected.
Why doesn't anything on the map appear?

Some apps will determine if you teleported from your last logged location to a new one too quickly. When this happens you get soft banned and have to wait up to 2 hours (or you can teleport back to the last location the app thought you were at).

For example, if you live in New York and log into your test app and then 5 minutes later you use GPS JoyStick to teleport yourself to California, it is obvious that you would not be able to move that far in such a short amount of time. To avoid this, wait at least 2 hours before opening the app.

Here is a link that shows the distance and associated timings: Cooldown Chart.
Why does "Disconnected From GPS" error occur and/or the map is not visible?

For the test app you see this error, you can ignore it as long as you can interact and use the app. To fix the blank map problem try these steps:
1. Open your collection.

2. Tap and open any creature.

3. Tap and open the Map. At this point the map should be visible. You may still see the "Disconnected From GPS" error but if you see things on the map and can interact with them you should be ok.
How do I stop the current location from rubberbanding/teleporting back and forth to my original location?

On some devices/Android versions this more prominent. To help reduce this you can try some or all of the below:

- As of February 2018, Google Play Services has a new update which causes random jumping. One thing you can try is to clear the Google Play Services cache and uninstall any updates. Also try clearing the app cache of the app you are trying to test. You can also try denying location permissions (or all permissions if that works for you) to the Google Play Services app.

- Try one of the GPS Jump fix options that are visible on the Home screen.

- Try and tweak the Process Interval in Settings. (This is advanced so be avoid if you do not know what you are doing).

- Alternatively, use the app indoors where you have a low gps signal.

- Some things other users have tried is placing a tin foil on the back — in between the case and the phone to block the gps signal.
How to prevent JoyStick from disappearring when I start another app? / How do I stop the JoyStick from disappearing and reappearing constantly?

On some devices/Android versions this more prominent. To help reduce this you can try some or all of the below:

- Unfortunately this can be phone/Android version specific. Make sure your phone is not too aggressive in force closing apps/services to preserve memory or battery. You will have to check your phone settings for this and may need to search online to find a solution that works for your phone.

- Another possible culprit can be "Memory" cleaner apps (such as Clean Master) which will automatically force kill services such as this one. You will have to find a setting to make GPS JoyStick an exception or disable the app when using GPS JoyStick.

- You can also try using an app called "Memory Locker" to reduce the amount of memory used by the GPS JoyStick app and the test app. You can try the following tutorial to reduce memory consumption for the test app (try at your own risk): https://forum.xda-developers.com/general/general/how-to-rum-pokemon-low-spec-devices-1gb-t3425263

- Also on some Android devices you can have a maximum of 3 foreground type services at any given time. Make sure you do not have other services running that would cause GPS JoyStick service to force close.

- To help prevent the location to reset back to the start location when the joystick disappears and reappears: Enable the Save Last Location option in Settings to auto save the last location as you walk. This is not recommended if your joystick is operating normally as it may degrade performance.

Setup

Automation

Troubleshooting