New: Custom routes

Build a route on the map and let your fake location travel along it.

• Switch the map to Route mode with the Location / Route toggle at the top.
• Tap the map to add points. Long-press and drag a point to move it, or tap it to delete it, move it earlier or later, or give it a new number. You can also reorder points by dragging them in the route panel.
• Tap a line between two points to set that section's speed (Walk, Run, Bike, Drive or a custom km/h), a wait time at its end point, and a speed variation for more natural movement.
• Set a default speed for the whole route, and turn on Loop (closed circuit) or Reverse.
• See the route's distance and estimated time as you build it.
• Press Play to start. A music-player style overlay lets you play, pause, stop, drag the progress bar to jump along the route, and switch between 0.5x, 1x and 2x speed. You can minimize it to a bubble, or control playback from the notification.
• One-time routes stop at the last point and offer Replay.
• Save routes to favorites. Favorites now have Locations and Routes tabs, where you can load, rename and delete routes.
• Your route in progress is kept between app launches, and saved routes are included in settings backups.
• A route and the joystick can't run at the same time.
• The overlay needs the "Display over other apps" permission. Without it, the route still plays with notification controls only.

New: Floating joystick

Move your fake location in real time while other apps are open.

• Tap the joystick button on the map screen (spoofing must be on and a location selected).
• Drag the joystick anywhere, minimize it to a bubble, or close it. You can also stop it from the notification.
• Live speed readout in km/h.
• Dynamic mode: speed follows how far you push the stick, up to the max speed (default 50 km/h).
• Constant speed mode: move at a Walk, Run, Bike or Drive preset and steer with the stick.
• Configure everything in Settings > Joystick. Joystick settings are included in settings backups.
• Requires the "Display over other apps" permission.

Fixes

• Map screen title no longer wraps onto two lines.

After updating, force-stop your target apps or reboot so the updated hooks load.

New features

• Export and import settings. Back up your spoofing settings, favorites and appearance to a file from the Settings screen, and restore them later or on another device. Importing replaces all current settings. Spoofing settings need the module enabled in LSPosed; if it isn't, only favorites and appearance are imported.
• Reset a single setting. Numeric and text settings can now be reset to their default value individually.

Improvements

• The side drawer now scrolls, so all items are reachable on small screens.
• Pull-to-refresh on the target apps list is smoother and scrolls back to the top when it finishes.

Full Changelog: noobexon1/XposedFakeLocation@v0.1.4...v0.1.5

What's Changed

• Make system Wi-Fi identity configurable by @Shallow-dusty in noobexon1/XposedFakeLocation#47

New Contributors

• @Shallow-dusty made their first contribution in noobexon1/XposedFakeLocation#47

Full Changelog: noobexon1/XposedFakeLocation@v0.1.3...v0.1.4

What's Changed

• hooks_refactor by @noobexon1 in noobexon1/XposedFakeLocation#42
• feat: Add German language localization by @ro011110ot in noobexon1/XposedFakeLocation#44

New Contributors

• @ro011110ot made their first contribution in noobexon1/XposedFakeLocation#44

Full Changelog: noobexon1/XposedFakeLocation@v0.1.2...v0.1.3

This release is mostly bug fixes. It also contains the addition of German as a language contributed by @ro011110ot ! Thanks! ❤️

What's Changed

• ui_improvements by @noobexon1 in noobexon1/XposedFakeLocation#39
• accuracy_refactor by @noobexon1 in noobexon1/XposedFakeLocation#40

Full Changelog: noobexon1/XposedFakeLocation@v0.1.1...v0.1.2

Release Notes

🚀 Features

Favorites

• Added editing functionality for favorite locations with UI dialogs and validation.
• Enhanced Favorites screen with comprehensive KDoc comments, improved state management, and detailed UI updates.
• Introduced an optional description field for favorite locations.
• Implemented navigation to the Favorites screen after successfully saving a new favorite location.

Map & Navigation

• Implemented map zoom persistence and retrieval functionality.
• Added dialogs for adding favorites and navigating to specific coordinates.
• Improved map UI with detailed documentation, better lifecycle management, and enhanced navigation drawer functionality.
• Implemented initial camera positioning based on user location.

Target Apps

• Added search functionality in the TargetAppsScreen to filter target apps efficiently.

Settings

• Introduced a theme selection feature (system default, light, dark themes).
• Added default values for numeric settings with a resetToDefaults() functionality.
• Implemented decimal rounding and decimal keyboards for numeric inputs.
• Restyled the Settings screen with search functionality and reordered sections.

🐛 Bug Fixes

• Changed the minimum SDK requirement to support Android 10.
• Refined precision handling for numeric settings to ensure consistent rounding behavior.
• Cleared relaunching packages when the module goes offline in TargetApps.
• Updated the inactive track color for sliders in the Settings screen for better visibility.
• Improved and refined the search functionality behavior and interaction in the Settings screen.
• Reformatted numeric fields on blur and ensured a stable state for key rows.

🔨 Refactors & Improvements

Performance

• Loaded AppIcon bitmaps asynchronously via produceState on Dispatchers.IO.
• Annotated TargetAppsUiState with @Immutable for performance optimization.

Architecture & State Management

• Streamlined map event handling and improved lifecycle awareness (e.g., using collectAsStateWithLifecycle).
• Consolidated settings UI state into a single StateFlow.
• Refactored TargetAppsScreen into thin stateful and stateless components.
• Centralized setting keys in a SettingKeys object for improved maintainability.
• Replaced MutableSharedFlow with Channel for one-shot events in view models.

UI/UX & Documentation

• Enhanced localization management, updated unit representations to use string resources, and improved the language setting UI.
• Cleaned up unused dialog components, menus, and imports across Map and Favorites screens.
• Reorganized package structures and improved the structure of test files.
• Added comprehensive KDoc comments across multiple view models and UI components for better clarity and maintainability.

New features

Address search

• Find a place by name with the new search button on the map. Results show as you type, nearest to where you're looking first.
• In Location mode a result places the marker. In Route mode it adds a route point named after the place.
• Uses the free Photon server by default; you can point it at your own server in Settings → Search & routing.

Routes that follow real roads

• Route sections can now follow streets like a navigation app instead of straight lines. Turn Follow roads on for the whole route, or set each section to Straight or Follow roads.
• Car, bike or foot roads are picked from the section's speed.
• Road paths are saved with the route, so playback, favorites and backups work offline once loaded.
• Sections whose road couldn't be loaded show a red ⚠ badge with Retry. Before playing, you can choose to play them as straight lines.
• The routing server can be changed in Settings → Search & routing.

New map: MapLibre (now the default)

• Sharper vector maps with light and dark styles that follow the app theme. The classic osmdroid map is still available in Settings → Map.
• You can set your own MapLibre style URL.
• Offline maps: download the area you're looking at and use the map without a connection. Downloads continue while you use the app and resume after losing the connection. Areas are named after the place automatically.
• Manage downloaded areas in Settings → Map → Offline areas: see their size, resume, rename or delete them.

Improvements

• The APK is much smaller: about 12 MB instead of 95 MB.
• Map choice and style URL are included in settings backups.

What's Changed

• Add address search to the map by @noobexon1 in noobexon1/XposedFakeLocation#60
• Road-following route segments by @noobexon1 in noobexon1/XposedFakeLocation#61
• MapLibre map renderer with offline areas by @noobexon1 in noobexon1/XposedFakeLocation#62
• Ship a smaller release APK (95 MB to 12 MB) by @noobexon1 in noobexon1/XposedFakeLocation#63

Full Changelog: noobexon1/XposedFakeLocation@v0.3.0...v0.4.0

PRs

• Stable_Refactor by @noobexon1 in noobexon1/XposedFakeLocation#36

XposedFakeLocation — Modern Xposed API Release

Highlights

• New Xposed API. Fully migrated from the legacy XposedBridge/XposedHelpers API to the modern io.github.libxposed API used by current LSPosed.
• Scope is now managed entirely from the app. Just enable the module in LSPosed — that's it. Selecting/deselecting target apps and toggling system-level hooks updates the LSPosed scope automatically. No more manual scope editing in LSPosed.
• Reactive updates. You only need to force-stop/restart a target app the first time it enters the scope. After that, changes you make in the manager (location, settings, start/stop) apply to the running target app immediately — no restart needed.

New features

• In-app target app selection that drives the module scope directly (add/remove apps from the Target Apps screen).
• "Enable system-level hooks" toggle (Settings) — adds the Android system framework (android) and phone process (com.android.phone) to the scope for deeper, system-level spoofing. Requires a reboot to take effect (and another to turn off).
• Root relaunch button — force-stop and reopen a target app straight from the Target Apps screen so spoofing applies right away (requires root).

Changes & cleanup

• Cross-process config now uses Xposed remote preferences (replacing the old XSharedPreferences/world-readable prefs), with a single source of truth split between hook-shared remote prefs and manager-only local prefs.
• Removed DataStore and the legacy module-enabled detection hack, blocking status check, and error screen — the manager binds to XposedService reactively instead.
• Removed the "Use built-in target app selection" setting; in-app target selection is now the default and only mode.
• Migrated the phone/system service hooks to the new API with name-based target attribution, gated so they stay inert unless you're actively spoofing a selected app.

Build / CI

• CI release workflow now builds on JDK 21 to match the project's Java 21 / Kotlin jvmTarget settings.

Requirements

• Rooted Android device, Android 11+ (API 30), and a modern LSPosed build (new API). Legacy Xposed/EdXposed and old LSPosed managers are not supported.

Full Changelog: noobexon1/XposedFakeLocation@v0.1.0...v0.1.1

What's Changed

• Users can define templates with coordinates and optional advanced mock-location settings, then assign each target app to use global settings, a selected template, or custom per-app overrides. Thanks to @MeGaNeKoS for this one! ❤️
• Added in-app language switching and Chinese localization support. You can change the language on the Settings page. Thanks to @guowenye for this improvement! ❤️
• In the About page of the app, you can now see all of the contributors to this project!
• We now have a TG discussion group. Join using the link in the app!

New Contributors

• @MeGaNeKoS made their first contribution in noobexon1/XposedFakeLocation#30
• @guowenye made their first contribution in noobexon1/XposedFakeLocation#32

Full Changelog: noobexon1/XposedFakeLocation@v0.0.9...v0.1.0

What's Changed

• Add hook-strategy toggle, external broadcast control, map zoom fix by @bjspi in noobexon1/XposedFakeLocation#21

New Contributors

• @bjspi made their first contribution in noobexon1/XposedFakeLocation#21

Full Changelog: noobexon1/XposedFakeLocation@v0.0.8...v0.0.9

Main changes:

1. You can now toggle the indicator Toast on and off in settings.
2. Map bugs fixed.
3. Improvements to UI/UX.
4. Can choose in settings if you want to hook the entire system framework or per app (as it was pre-release 0.0.7)
5. Can choose in settings to register a broadcast receiver for communicating with other apps.

Thank you so much, @bjspi and @lytalk, for contributing to making this project better! ❤️

If you find any bugs, please let us know so we can fix them.

Cheers!

What's Changed

• fix: support GMS-backed target app location spoofing by @lytalk in noobexon1/XposedFakeLocation#24

Full Changelog: noobexon1/XposedFakeLocation@v0.0.7...v0.0.8

Quick fix for non-MIUI devices.

What's Changed

• Enhanced: Refactored parts of the hook implementation by @lytalk in noobexon1/XposedFakeLocation#20

Full Changelog: noobexon1/XposedFakeLocation@v0.0.6...v0.0.7

This is a HUGE improvement over the previous version. Thanks to @lytalk for taking the time and effort to improve XposedFakeLocation for everyone!

As many of you requested, the module now works globally. What does that mean for you? Well, from now on, XposedFakeLocation is where you manage your target apps. You don't need to head over to your Xposed module manager to change your targets anymore. Please make sure that you refer to the README.md file and read the new setup instructions. Before opening any issues, make sure that you didn't mess up the setup.

Cheers! ❤️ 🚀 🔥

What's Changed

• feat: keep current location after fakelocation stops(fixes issue #4) by @lytalk in noobexon1/XposedFakeLocation#9

New Contributors

• @lytalk made their first contribution in noobexon1/XposedFakeLocation#9

Full Changelog: noobexon1/XposedFakeLocation@v0.0.5...v0.0.6