whatisgithub

What is modify_positioning?

auroranest/modify_positioning — explained in plain English

Analysis updated 2026-05-18

74KotlinAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A no-root Android app that injects a chosen fake GPS location into the phone's standard location system for developer testing.

Mindmap

mindmap
  root((repo))
    What it does
      Mock GPS location
      No root required
      Foreground service injection
    Tech stack
      Kotlin
      Jetpack Compose
      Android
    Providers
      GPS provider
      Network provider
      Fused Location Provider
    Features
      Diagnostics screen
      Travel scenario presets
      OSM default map
    Audience
      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-based app behaves at different simulated GPS coordinates.

USE CASE 2

Verify that GPS, network, and fused location providers all report a consistent test position.

USE CASE 3

Use preset travel scenarios to check how an app handles ongoing movement over time.

What is it built with?

KotlinJetpack ComposeAndroid

How does it compare?

auroranest/modify_positioninghuyujie275-gif/bloodsugarappbusung-dev/root-my-galaxy
Stars747570
LanguageKotlinKotlinKotlin
Setup difficultymoderatemoderatemoderate
Complexity3/54/53/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Android Studio, JDK 17, and enabling the app as the system mock location app in developer options.

So what is it?

Modify Positioning is an Android app that lets you set a fake GPS location without rooting your phone. It works by using Android's own official mock location feature, which lets a designated app feed test coordinates into the phone's normal location system so that other apps checking for GPS, network, or fused location can read them. The stated goal is to give developers and testers a reliable way to check how location based features, like map pin selection or foreground location services, behave under different simulated positions. Once you pick a point on the map, the app starts a foreground service that pushes that location into the system repeatedly, and instead of holding a location that never moves, it drifts gently around the target so the reading looks closer to how a stationary phone actually behaves. It writes the same simulated position into three places at once, the GPS provider, the network provider, and Google's Fused Location Provider, so anything reading location through the standard Android APIs sees a consistent result. It also includes a diagnostics screen showing device details, permission status, and whether each of those three location channels is currently healthy, along with preset travel scenarios for Los Angeles and New York that can be used as templates for further testing. The default map source is OpenStreetMap, with an optional AMap integration available if you supply your own API keys. A separate iOS focused approach is referenced through a Git submodule that points to another developer's project, and the README is explicit that this iOS piece is not original work from this repository. The README states clearly what the project does not attempt: it does not hide the fact that mock locations are active, does not try to defeat any specific app's detection of simulated locations, and does not use root access, Xposed style hooking, or altering other apps directly. Built in Kotlin using Jetpack Compose, it requires Android Studio, JDK 17, and can be built and installed using standard Gradle commands.

Copy-paste prompts

Prompt 1
Explain how Modify Positioning injects a mock location into GPS, network, and fused providers at once.
Prompt 2
Walk me through building and installing this Kotlin app with Gradle and Android Studio.
Prompt 3
Show me how the diagnostics screen reports whether each location provider is healthy.
Prompt 4
Help me understand what this project explicitly says it does not attempt to do.

Frequently asked questions

What is modify_positioning?

A no-root Android app that injects a chosen fake GPS location into the phone's standard location system for developer testing.

What language is modify_positioning written in?

Mainly Kotlin. The stack also includes Kotlin, Jetpack Compose, Android.

How hard is modify_positioning to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is modify_positioning for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.