explaingit

kamui2040/k2040-geojoystick

Analysis updated 2026-05-18

6JavaAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

An open-source Android app that fakes your GPS location through a draggable on-screen joystick, built for developer and emulator testing.

Mindmap

mindmap
  root((GeoJoystick))
    What it does
      Mock GPS location
      Floating joystick overlay
      Map based coordinate picker
    Tech stack
      Java
      Android
      OpenStreetMap
    Use cases
      Test location aware apps
      Simulate walking or biking routes
      Save favorite test locations
    Audience
      Android developers
      QA testers

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

What do people build with it?

USE CASE 1

Test how a location aware app behaves at a specific latitude and longitude without traveling there.

USE CASE 2

Simulate walking, running, or biking movement along a route for app testing.

USE CASE 3

Save named favorite test locations to switch between quickly during development.

What is it built with?

JavaAndroidOpenStreetMapLeaflet

How does it compare?

kamui2040/k2040-geojoystickblackfan/s3-request-signerandroid-hacker/xposedwechathelper
Stars667
LanguageJavaJavaJava
Last pushed2018-03-13
MaintenanceDormant
Setup difficultyeasymoderatehard
Complexity2/53/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires enabling mock-location and display-over-other-apps permissions on the Android device, building from source needs the Android SDK and JDK.

You can use, modify, and share the app, and any modified version you distribute must also stay open source under the same GPL-3.0 license.

In plain English

GeoJoystick is an open source Android app that lets you fake your phone GPS location for testing purposes, controlled through a small floating joystick you can drag on screen. It works through Android official mock location system, so it never tries to hide the fact that a fake location is active, and it only publishes a fake position while its foreground service is running with a visible notification. You set a location by typing in latitude, longitude, and altitude, using a built in OpenStreetMap map picker that needs no external JavaScript or API key, or by importing coordinates from a copied map link. Once a position is set, a floating joystick overlay lets you move around at different speeds, with presets for walking, running, and biking, plus your own custom speed. You can hold, pause, hide, or stop the movement, switch the overlay between an expanded and a compact layout, and the app remembers your last overlay mode and speed preset the next time you open it. Other settings include light, dark, or system appearance, English or German language, adjustable overlay opacity, a high contrast mode, up to five named favorite locations, and an option to restore your last active position automatically. The app has no ads, subscriptions, accounts, analytics, billing, or built in updater. It is free to use, and the developer, known as K2040, accepts optional support through Ko-fi with no paid features tied to it. It is available as a GitHub release or through APKPure, with GitHub Releases treated as the main source for release notes. To build the project yourself on Windows, you run an included build script instead of a committed Gradle wrapper. The script finds Android Studio JDK and SDK, downloads and verifies Gradle itself, and produces a debug APK. To use the app you install it, grant permission to display over other apps, choose it as the mock location app in Android developer options, then pick a location and start the overlay. GeoJoystick is licensed under GPL-3.0.

Copy-paste prompts

Prompt 1
Walk me through setting up GeoJoystick as the mock location app in Android developer options.
Prompt 2
Explain how GeoJoystick's OpenStreetMap picker lets me import coordinates from a shared map link.
Prompt 3
Help me run GeoJoystick's Windows build script to produce a debug APK.
Prompt 4
Suggest a test plan for using GeoJoystick's speed presets to validate a location tracking feature in my app.

Frequently asked questions

What is k2040-geojoystick?

An open-source Android app that fakes your GPS location through a draggable on-screen joystick, built for developer and emulator testing.

What language is k2040-geojoystick written in?

Mainly Java. The stack also includes Java, Android, OpenStreetMap.

What license does k2040-geojoystick use?

You can use, modify, and share the app, and any modified version you distribute must also stay open source under the same GPL-3.0 license.

How hard is k2040-geojoystick to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is k2040-geojoystick for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.