Getting started

Follow these steps in order. When you finish, LocoLarp can send a test location to other apps on the same Android phone.

1. Check the phone

1. The phone must run Android 8.0 (API 26) or newer.
2. You must be able to open Settings and install an app.
3. If this is a work phone, a company policy may block mock locations. See troubleshooting.

2. Install LocoLarp

1. Open the download page and save locolarp-1.1.4.apk on the phone. No key is required to download. Buy a key with a card on Stripe (week and month auto-renew), then paste it in the app under Settings → License. Without a key, Start stays locked.
2. On the phone, open the APK file and tap Install.
3. If Android asks you to allow installs from this source, allow it only for the app you used to open the file (for example Files).

3. Turn on mock location

Android will not accept a simulated location until you pick LocoLarp as the mock location app. That lives in Developer Options.

1. Open Settings → About phone.
2. Tap Build number seven times until you see a message that you are a developer.
3. Go back, open Developer options, find Select mock location app, and choose LocoLarp.

Samsung, Xiaomi, and other brands hide these menus in slightly different places. Use the Android setup guide for those.

4. Choose a location and start

1. Open LocoLarp and paste your key in Settings → License.
2. Search, tap the map, draw a path, or load a saved preset.
3. Tap Start Simulation. The status should change from Simulation Off to Simulation On.
4. Open the app you want to test. If it uses Android location APIs, it should see the test coordinate.

5. Stop when you are done

1. In LocoLarp, tap Stop Simulation.
2. Optionally deselect LocoLarp in Select mock location app so nothing else can mock.