Files
OpenLoc/README_EN.md
T
LZX 7b0d5b802d
Release OpenLoc APKs / Build & Publish Release (push) Canceled after 0s
release: v1.2.2 - add about screen, migrate update server to VPS, and optimize UI
2026-11-08 15:23:10 +08:00

71 lines
4.9 KiB
Markdown

<p align="center">
<img src="assets/logo.png" width="128" height="128" alt="OpenLoc Logo" />
</p>
<h1 align="center">OpenLoc</h1>
<p align="center">
A modern location simulation and privacy assistant tailored for the Android platform
</p>
<p align="center">
<img src="https://img.shields.io/badge/Platform-Android-3DDC84?style=flat-square&logo=android&logoColor=white" alt="Platform" />
<img src="https://img.shields.io/badge/Language-Kotlin-7F52FF?style=flat-square&logo=kotlin&logoColor=white" alt="Language" />
<img src="https://img.shields.io/badge/UI-Jetpack%20Compose%20%2F%20Material%203-4285F4?style=flat-square&logo=jetpackcompose&logoColor=white" alt="UI" />
<br>
<img src="https://img.shields.io/badge/Privacy-Local%20Only-00C853?style=flat-square" alt="Privacy" />
<img src="https://img.shields.io/badge/License-GPL--3.0-007AFF?style=flat-square" alt="License" />
</p>
<p align="center">
<a href="README.md">简体中文</a> | <b>English</b>
</p>
---
OpenLoc is designed for developers, QA engineers, and privacy-conscious users who require a secure, controllable, and clean mock location environment. Built on top of runtime hooking via Xposed / LSPosed alongside modern Android architectural components, OpenLoc delivers high-fidelity, residue-free multi-dimensional environmental simulation.
---
## Core Architecture & Implementation
### 1. Low-Level Hooking & Multi-Dimensional Geolocation Interception
- **System-Level Deep Hooking**: Deeply hooks into Android's core `LocationManagerService`, network location providers, and third-party NLP frameworks via Xposed to intercept GNSS data, cellular base station scans, and Wi-Fi networks.
- **In-Memory Mock Flag Sanitization**: Clears the `isMock` and `mIsFromMockProvider` fields in memory objects in real time, eliminating fundamental mock location signatures at the source.
- **Module Package Self-Stealth**: Transparently conceals OpenLoc's own package information from monitored applications, defeating detection mechanisms that scan installed packages via `PackageManager`.
### 2. Multi-Dimensional Realism & Anti-Detection Matrix
- **Natural Location Drift**: Employs Gaussian smoothing and Brownian motion random walk models to dynamically generate lifelike subtle coordinate drifts, preventing risk control alarms triggered by absolute static coordinates.
- **Full Constellation GNSS Simulation**: Simulates physical Carrier-to-Noise ratio (C/N0) and pseudoranges across GPS, BeiDou, GLONASS, and Galileo constellations, generating compliant full-stream NMEA GSV/GSA sentences.
- **Physiological Micro-Tremor Simulation**: Injects subtle physiological tremors into the device's accelerometer sensors, replicating natural handheld micro-movements to bypass gait and stationary posture detections.
- **Cell Tower & Wi-Fi Camouflage**: Sanitizes and obfuscates nearby cellular cell identifiers and Wi-Fi BSSIDs, preventing apps from querying cloud fingerprint databases to trace real physical locations.
### 3. Granular Application Scope Management
- **Versatile Scope Policies**:
- **Global Mode**: All applications across the system receive simulated coordinates.
- **Blacklist Mode**: Designated blacklisted applications retain real physical positioning, while all other applications receive simulated locations.
- **Whitelist Mode**: Only explicitly whitelisted applications receive simulated locations, leaving all other applications untouched.
- **Intuitive App Selector**: Equipped with fast search indexing, category filtering (System vs. User apps), and bulk selection capabilities.
### 4. Interactive Map & Favorites Management
- **Modern Map Interaction**: Integrated with OpenStreetMap engine for fluid gestures, smooth zooming, and accurate coordinate selection.
- **Multi-Engine Geosearch**: Supports diverse search providers including AMap, Baidu Maps, Photon, and Nominatim, with direct coordinate jump functionality.
- **Favorites & Waypoints**: Save and name custom locations with instant switching, drag-to-reorder, and persistent local storage.
### 5. Clean Experience & Internationalization
- **Jetpack Compose & Material 3**: Built with a modern declarative UI framework, supporting Material You dynamic color extraction and customizable palette themes with light/dark modes.
- **Strict Internationalization (i18n)**: All UI strings are completely decoupled with zero hardcoded text, providing comprehensive native support for Simplified Chinese and English.
- **Pure Local Execution**: Zero background daemon overhead and zero external analytics; all privacy configurations remain strictly on the local device.
---
## Disclaimer
This software is intended solely for legitimate software development, academic research, geolocation testing, and personal privacy protection. Please do not use it for any activity that violates laws, regulations, or third-party service agreements.
---
## License
This project is licensed under the **GNU General Public License v3.0 (GPL-3.0)**. See the [LICENSE](LICENSE) file for details.