Map

The map shows your location as a marker. Buttons on it open search, paste, routes, favorites, and roaming. Map tiles come from Settings → General → Map source. If the map does not appear, see Troubleshooting.

What you see

You open the app with spoofing on

The map loads. With spoofing off, the Home screen loads first. Open the side menu to reach the map.

You never set a position

The map starts at your real location.

You drag the map

It stops following your marker. Tap the center button to follow again. With spoofing off, it centers on your real location and keeps your saved position.

A walk, route, or roam is idle

Its button is grey.

A walk, route, or roam is moving

Its button is green.

A walk, route, or roam is paused

Its button is orange. Tap it to open the controls, then tap Resume.

Spoofing is on

A small speed readout sits at the top left of the map. It uses the speed unit you picked in Settings and shows 0.0 when you are paused or standing still.

To stop or pause a walk, tap its button on the map and use the controls. To change speed, use the speed button on the widget.

  1. Tap the search button (magnifying glass).
  2. Type a place name, address, or landmark.
  3. Pick a result to place a marker there.
  4. Choose an action in the sheet that opens. If spoofing is off, the app teleports at once.

Paste coordinates

Prerequisites: Turn on the paste button in Settings → Menus → App features.

  1. Tap the paste button (clipboard icon) on the map or widget.
  2. Paste or type coordinates, one point per line. Formats are listed in Routes.
  3. Choose an action.
  • One point: Teleport, Walk, Walk via roads, or Save favorite. Teleport works offline.
  • Two or more points: Save route, Start route, and the route options in Routes.
  • Start route plays the points without saving them. The next paste replaces it.
  • Save route never overwrites an existing route, even with the same name.
  • The app ignores lines it does not recognize. If none are valid, it says so.
  • The box grows to 10 lines, then scrolls. Select all and Clear all sit below it.

Open a GPX file

Open a GPX file from Files, Downloads, Share, or a chat app. The paste sheet opens titled "Open GPX" with the points filled in. Pick an action as above. Save route suggests the file name. If the file is not valid GPX, a message says so.

Tap to move

Tap a point on the map to open a sheet of actions. Long-press a point to walk there in a straight line at once, with no sheet.

If spoofing is off, a tap teleports at once. Teleport features turned off in Settings hide the Teleport action.

Teleport here

Jump to the point at once. Any running or paused route or roam ends first. Works offline. If spoofing is paused, tap Start first.

Walk here

Walk to the point in a straight line at your current speed.

Walk via roads

Walk along real roads at your current speed. See when roads cannot load.

Add next point

While walking, add a stop. The first tap continues from where you are now to your destination, then the new point. Later taps add more stops. If you are following roads, the new stretch does too.

Share a location

Tap the share icon at the top of the sheet to copy the point's coordinates or send a link to it. The floating map has the same icon, and it shares your current position. See Location Links.

While a saved route plays

Choose Stop route and teleport, Stop route and walk here, or Finish route and walk here. Finish adds the point to the route's end.

Walking via roads, road-following routes, and roaming load paths from an online service. If it is unreachable, the app uses a straight line for that stretch.

Teleport wait

Some games block quick jumps. Before you teleport, the app shows a suggested wait based on the distance jumped. The wait is advice only. Nothing is blocked.

Between rows, the lower row applies. Distance is a straight line from your position to the target.

Routes sheet

  1. Tap the routes button on the map.
  2. Tap a route to preview its path.
  3. Choose Start, Loop, or Reverse.
  4. Use Previous stop and Next stop to skip waypoints. A count like 3/12 shows your current stop.

See Replay options for more.

Favorites sheet

  1. Tap the favorites button on the map.
  2. Tap a favorite and pick Set location (teleport), Walk to location (straight line), or Walk via roads.
  3. Type in the search box to filter by name or area. Closing the sheet clears it.
  4. Tap Save current location to add where you are now.

Each favorite shows its straight-line distance. Road distance is longer. Teleport ends any running or paused route or roam.

Roaming sheet

Prerequisites: Pause or stop a playing route first. Only one roaming mode runs at a time.

  1. Tap the roaming button on the map.
  2. Choose a mode.
  3. Set radius, distance, speed, or loop count. Defaults are in Settings → Roaming.
  4. Tap Generate to preview the path.
  5. Tap Start roaming. It keeps going with the screen off.

Walk around the block

Walks to random spots within a radius.

Planting

Walks a spiral that opens out, then tightens. One spiral is one loop. Tick Expand only to walk the spiral out once and stop.

Changing speed during roaming replaces the speed you set here.

Side menu

Tap the menu button at the top left to open the side menu. It lists these entries.

Home screen badges

Update available

Shows when: GitHub has a newer release. Checked once a day. Needs internet.

Dismiss by: Tap X. Hidden until a newer version comes out.

What's new

Shows when: After an update, showing what changed. Works offline.

Dismiss by: Tap X. Hidden until the next version. See the changelog.