explaingit

zcshou/gogogo

10,439JavaAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

An Android app that lets you fake your phone's GPS location without root access, using Android developer tools and a map interface to pick any coordinates you want.

Mindmap

mindmap
  root((repo))
    What it does
      Fake GPS location
      No root needed
      Android 8.0 and up
    Input Methods
      Map tap
      Coordinate entry
      Search by name
      Location history
    Features
      Virtual joystick
      Simulated movement
      Baidu Maps
    Audience
      Android developers
      Mobile testers
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Simulate walking through a location on your Android phone using the virtual joystick without physically moving.

USE CASE 2

Test location-based features in your Android app by spoofing GPS to specific coordinates during development.

USE CASE 3

Learn how to integrate Android developer mock location APIs and Baidu Maps SDK in a Java Android project.

Tech stack

JavaAndroidBaidu Maps SDK

Getting it running

Difficulty · moderate Time to first run · 30min

Requires enabling developer options and mock location permission on the Android device, no root access needed.

GPL-3.0: you can use and modify freely, but any app you distribute that includes this code must also be released as open source under GPL-3.0.

In plain English

GoGoGo, known in Chinese as "影梭", is an Android app that lets you change your phone's reported GPS location without needing root access. It works on Android 8.0 and newer. The app uses Android's built-in developer debugging tools along with the Baidu Maps SDK to make your phone report a different position to other apps. You can pick a location by tapping the map, typing in coordinates directly, searching by name, or browsing your history of previous locations. The app also includes a virtual joystick so you can simulate walking or moving through a location over time, rather than just jumping to a fixed point. The developer originally built it while playing a location-based mobile game and wanted a free alternative to the paid spoofing apps that already existed. The project was released publicly to share the learning experience around Android development and map integration. The README is written primarily in Chinese and includes several strong warnings. The developer explicitly states the app should not be used to cheat in school fitness apps or games, and notes that a third party copied the code, added ads, and released it without complying with the GPL-3.0 open source license, which the developer considers a violation. The project is licensed under GPL-3.0, meaning anyone who distributes modified versions must also release the source code. The codebase is described as the author's first Android app, written as a learning exercise rather than a polished product.

Copy-paste prompts

Prompt 1
I want to build an Android app similar to zcshou/gogogo that lets users set a fake GPS location. Help me implement the mock location provider using Android developer options API in Java.
Prompt 2
How does zcshou/gogogo implement the virtual joystick for simulating movement? Help me understand the Android touch input handling and GPS coordinate update logic.
Prompt 3
I'm studying the gogogo Android project. Help me add a feature to replay a saved GPS route automatically instead of using the manual joystick.
Open on GitHub → Explain another repo

← zcshou on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.