Automation
GPS JoyStick supports automation via Android Intents. You can control it from Tasker, ADB shell, MacroDroid, or any app that can send Android Intents.
Quick links: Pro Intents API | Tasker | MacroDroid | ADB Commands | Deep Links
Detailed Guides
If you are looking for comprehensive documentation beyond the quick reference below, these guides cover each integration in depth:
Pro Intents API Overview: Complete documentation of all intent actions, extras, and response broadcasts. Start here if you want to understand everything GPS JoyStick exposes for programmatic control.
Tasker Integration Guide: Step-by-step Tasker setup with downloadable profiles and ready-made automation recipes. Covers both free and Pro intents with real-world examples.
MacroDroid Integration Guide: MacroDroid as an alternative to Tasker, with a visual comparison of how the same automations translate between the two tools.
ADB Commands Reference: Shell-based control for scripting, automated testing, and CI pipelines. Useful when you need to drive GPS JoyStick from a computer rather than an on-device automation app.
Basic Intents (Free)
These intents work with the free version:
| Action | Description |
|---|---|
theappninjas.gpsjoystick.TELEPORT | Teleport to coordinates (lat, lng, alt) |
theappninjas.gpsjoystick.ROUTE | Start a saved route by name |
theappninjas.gpsjoystick.STOP | Stop all mocking |
Pro Intents
These require a Pro subscription:
| Action | Description |
|---|---|
theappninjas.gpsjoystick.WALK | Walk through waypoints |
theappninjas.gpsjoystick.ROUTE_PAUSE | Pause the current route |
theappninjas.gpsjoystick.ROUTE_RESUME | Resume a paused route |
theappninjas.gpsjoystick.ROUTE_NEXT | Skip to the next waypoint |
theappninjas.gpsjoystick.ROUTE_PREV | Go back to the previous waypoint |
theappninjas.gpsjoystick.HIDE | Hide the on-screen joystick |
theappninjas.gpsjoystick.SHOW | Show the on-screen joystick |
theappninjas.gpsjoystick.SPEED | Set movement speed (km/h) |
theappninjas.gpsjoystick.FAVORITES | Teleport to a saved favorite |
theappninjas.gpsjoystick.RECORD_START | Start recording a route |
theappninjas.gpsjoystick.RECORD_ADD | Add waypoint to recording |
theappninjas.gpsjoystick.RECORD_STOP | Stop recording (save or discard) |
theappninjas.gpsjoystick.GENERATE | Generate and walk a random route |
theappninjas.gpsjoystick.STATUS | Query current runtime state |
Receiving Broadcasts
Some intents broadcast a response. All intents broadcast theappninjas.gpsjoystick.ERROR on failure.
Error extras: source_action (the intent that failed), error (error code), message (description).
Common error codes: PRO_REQUIRED, INVALID_EXTRAS, FAVORITE_NOT_FOUND, NOT_RECORDING, SAVE_FAILED, NOT_WALKING, NO_ROUTE_ACTIVE, ALREADY_RECORDING.
If the service is not running when an intent is received, the app will automatically launch and attempt to process the command.