Introduction

LSPatch is the rootless companion to Vector, the Xposed framework this project is built on. Where Vector hooks the whole system as a Zygisk module and needs Magisk or KernelSU, LSPatch needs neither: it rewrites a single target app's APK to embed the loader and framework runtime, so that one app loads your Xposed modules on its own.

The two share a codebase — the same LSPlant-based hook engine and the same manager UI — and run the same modules. Read Vector's documentation for anything about the framework itself; this README only covers what is specific to the rootless path.

Modules

Both generations of Xposed module run through the same engine, so the module repository and the API references listed under Vector's Developer Resources apply unchanged:

• Modern — libxposed modules receive a real IXposedService.
• Legacy — classic de.robv.android.xposed modules keep working as-is.

Requirements

• Android 9 (API 28) or newer. The upper bound follows Vector — see its compatibility notes.
• Shizuku (optional). With it, the manager installs patched apps silently; without it, grant "install unknown apps" once and install by hand.

Downloads

Each release ships the manager (manager.apk) and the command-line patcher (lspatch.jar), plus a -debug build of each. When reporting a bug, please reproduce it on the debug build first.

Usage

Manager app — install manager.apk, pick a target, patch it, and install the result. From there you manage each patched app's modules in place, install modules from the store, and read a live framework log. Two modes:

• Manager mode keeps the patched app bound to the manager, so module changes apply without re-patching.
• Integrated mode bakes the modules into the APK, producing a self-contained app that needs no manager afterwards.

Command line — download lspatch.jar and run java -jar lspatch.jar to patch an APK from a shell.

Contributing

• Translations are managed on Crowdin.
• Questions go to Discussions; bug reports to Issues.
• Code style is enforced by Spotless — run ./gradlew spotlessApply before submitting. It formats only the files you changed (ktfmt for Kotlin, palantir-java-format for Java), so you never reflow untouched code.

Credits

• Vector — the Xposed framework and shared manager UI LSPatch is built on (and its own credits)
• Xpatch — the project LSPatch originally forked from
• apkzlib — APK repacking

LSPatch v1.2

LSPatch 1.2 adds an opt-in level 3 to the signature bypass, reaches a module's companion the moment its settings open, and fixes several crashes carried over from 1.1.

• 🔏 Signature bypass, level 3. Levels 1 and 2 miss an app that reads its own apk through an inline svc or parses it with getPackageArchiveInfo. Level 3 redirects both to the original signer. It rewrites four bytes of the app's own code, which a self-checksumming packer can notice, so it stays opt-in and arm64 only; level 2 remains the default.
• 🔌 A companion is reached when its settings open. A value changed in a module's settings app now reaches the running hook without force-stopping the target first — over Shizuku where it is granted, or through a service the companion binds at its own start where it is not.
• ⬆️ Version history and canaries on the update page. Pick any past or prerelease build from the title-bar switcher and follow its notes, channel and install.
• 🩹 Crash fixes. Choosing a language, running a local-mode app under a renamed manager, or re-patching a patched app in a release build no longer crashes.