README.md

Neo LSPatch Framework

Rootless Xposed framework powered by Vector core.

Official Website: npatch.nkbe.top

Introduction

NPatch patches an Xposed loader and the Vector core directly into the target APK, allowing Xposed modules to run seamlessly without Root privileges or system modifications. The patched APK carries its own loader and native core, with no extra extraction required at runtime.

Patching Modes

• Local Mode (--manager): Patches apps without embedding modules. Modules and scope are managed dynamically by NPatch Manager, so changing or updating modules requires no re-patching.
• Integrated Mode (--embed): Embeds modules directly into the patched APK, running standalone without requiring NPatch Manager.

Recent hook-stack stability improvements:

• LSPlt: avoids a transient unmapped GOT/PLT region while installing hooks. This prevents dex2oat/zygote crashes on affected 32-bit Android 10 devices.
• LSPlant: initializes CloseGuard for synthetic DexFile objects on Android Nougat and below, and aligns hook trampolines correctly for improved ART hook compatibility.

We sincerely invite you to join our Telegram group to get more information and updates about NPatch.

Supported Versions

• Minimum: Android 9 (API 28)
• Maximum: Android 17 (SDK 37)

Download

• Stable Releases: Available on GitHub Releases
• Canary Builds: Test versions released by developers, available on the Telegram channel @ONPatch

Usage

Through Manager (Recommended)

1. Download manager-v<verName>-<verCode>-release.apk from Releases and install it.
2. Select target application and patch it on-device with GUI guidance.

Through CLI (Jar)

java -jar jar-v<verName>-<verCode>-release.jar --manager target.apk

See the Usage Guide for detailed CLI arguments and options.

Star History

Credits

• Vector: Core runtime
• Xpatch: Fork source
• Apkzlib: Repacking tool

License

NPatch is licensed under the GNU General Public License v3 (GPL-3) (http://www.gnu.org/copyleft/gpl.html).