How to Install LSPosed or Vector and Enable Modules
Three things are called LSPosed now: the old 1.9.2, the closed-source LSPosed 2.x and the open-source fork Vector. Which to install, Zygisk, modules and fixes.
LSPosed is the framework that runs Xposed modules on modern Android. Modules change how the system or individual apps behave, in memory, without modifying any APK, and turning one off and restarting undoes it. Before installing, you need to know which LSPosed to get: in October 2026, three different things go by that name, and they don’t load the same modules.
Which one to install
| LSPosed 1.9.2 | LSPosed 2.x | Vector | |
|---|---|---|---|
| Made by | The LSPosed team | The same team | JingMatrix, from a fork of LSPosed |
| Latest release | v1.9.2, October 2023 | v2.2.1, 5 October 2026 | v2.2, 4 August 2026 |
| Source code | Public, GPL-3.0 | Not published | Public, GPL-3.0 |
| Where to get it | GitHub releases | lsposed.zip and the team’s Telegram channel | GitHub releases |
| Android | 8.1 to 14 | 9 to 17 | 8.1 to 17 |
| Root | Magisk 24 or later | Magisk 27 or later, KernelSU or APatch | Magisk or KernelSU, per its README |
| Modules for libxposed API 101 | No | Yes | Yes, since 2.1 |
| Modules built only for API 100 | Yes | No | No, since 2.1 |
- LSPosed 1.9.2 is the last release on the original project’s GitHub. Its README lists Android 8.1 to 14, and the repository hasn’t changed since January 2024. It still offers a Riru download next to the Zygisk one; Riru is archived, and the LSPosed team said in 2024 that it no longer works with Magisk 27.
- LSPosed 2.x is the same team’s new version, released since March 2026 without its source code. In 2024 the team announced internal testing in which “beta testers will not have access to the software’s source code”, saying it would afterwards “consider open-sourcing the software entirely or partially”; that hasn’t happened. The project’s website, lsposed.org, links to lsposed.zip for the download. Its installer contacts a server to request a licence (more below), and the manager and service APKs inside 2.2.1 are signed with an Android Debug certificate rather than the team’s own key. The README inside the zip still sends you to GitHub for stable releases, where the latest is 1.9.2.
- Vector is JingMatrix’s fork of LSPosed. It was released as “LSPosed” 1.10 and 1.11 until January 2026 and renamed Vector with version 2.0 in March 2026; the old address, github.com/JingMatrix/LSPosed, now leads to it. Besides releases, it publishes “canary” builds as GitHub pre-releases, which its notes describe as “the current state of master, tested by CI and nothing else”.
On Android 15 or later, the choice is between LSPosed 2.x and Vector. The steps below follow Vector, whose code and releases are public. LSPosed 2.x installs the same way through your root manager, with the differences listed after the steps. Whichever you choose, install only one at a time (see switching).
Modules and the API they were built for
Modules come in two kinds, and the framework you pick decides which ones load:
- Classic Xposed modules load in all three.
- Modules for the newer libxposed API declare a version. API 100 is an early, never officially published version of that API, which LSPosed 1.9 introduced and Vector up to 2.0 implement. Version 101 was published in March 2026 and changed the interface. Vector 2.1 and later and LSPosed 2.x refuse modules built only for API 100; Vector shows them as “Enabled, but built for libxposed API 100, which this framework no longer loads.” A module that needs API 101 doesn’t load in LSPosed 1.9.2 or Vector 2.0 and older.
We read the entry points in each module APK we host. For the modules on this site:
| Module | Built for | Vector 2.1+, LSPosed 2.x | LSPosed 1.9.2, Vector 2.0 and older |
|---|---|---|---|
| Disable Target API Block, NoStorageRestrict, Free Notifications, KnoxPatch, Cirno | Classic API | Yes | Yes |
| Global Icon Pack | Both, libxposed API 101 and classic | Yes | Not certain: LSPosed 1.9.2 uses a module’s newer entry point whenever it has one |
| HideMockLocation | libxposed API 101 | Yes | No |
| Pengeek (the A101 file we host) | libxposed API 101 | Yes | No |
| The optional module in Hail | libxposed API 101 | Yes | No |
What you need first
- Root, with an unlocked bootloader: Magisk, KernelSU or APatch. Our root guide covers unlocking and Magisk, and the root solutions comparison helps you choose. Vector’s README names Magisk and KernelSU; it doesn’t list APatch, though Vector’s code recognises it.
- Zygisk, the part that loads the framework into apps:
- Magisk has it built in. Turn on Zygisk in Magisk’s settings and reboot.
- KernelSU and APatch have no built-in Zygisk, by their own documentation. Install a Zygisk module first. Vector’s README gives NeoZygisk as the example, KernelSU’s FAQ names ZygiskNext, and APatch’s FAQ lists ZygiskNext, ReZygisk and NeoZygisk. NeoZygisk, by Vector’s developer, and ReZygisk are open source; ZygiskNext stopped being open source after its version 0.9.1.1.
- If you use ReZygisk or ZygiskNext on Magisk, both projects say to turn Magisk’s own Zygisk off.
- For LSPosed 2.x only: Magisk 27 or later (the installer stops on older versions with “Please install Magisk v27+”), or a KernelSU manager 1.0.1 or later, and a root manager from after August 2024, which the team says is needed for its XZ-compressed zip.
Install Vector
- Download the latest release from Vector’s GitHub releases: the file ending in
-Release.zip, for exampleVector-v2.2-3080-Release.zip. The-Debug.ziplogs far more; the README asks for the latest debug build in bug reports. - Install it as a module in your root manager’s Modules screen. The installer checks every file it extracts against its checksum and stops if the zip is damaged.
- Make sure Zygisk is active (see above).
- Reboot.
- Open the manager. A notification, “Vector loaded – Tap the notification to open manager”, appears after boot. You can also tap the module’s Action button in Magisk 28 or later, KernelSU or APatch, or dial
*#*#832867#*#*(“VECTOR” on the keypad). The manager isn’t installed as an ordinary app, so no icon appears in your launcher; in its own words, “Vector runs inside another process rather than being installed”. It offers a home screen shortcut or Install as an app so you can find it again. - Check the status at the top of the manager: “Active” means it is running. “Needs attention” names what failed, for example an SELinux policy the root solution didn’t apply. “Not activated” means the manager found no running framework; check Zygisk first.
LSPosed 2.x differs in a few steps:
- The zip comes from lsposed.zip. The installer refuses to run from a custom recovery (“Install from recovery is NOT supported”).
- It needs an internet connection while installing. It runs a bundled tool under the heading “Requesting license”. If that fails, it shows “Failed to request license” and “Please request another package from bot or try again later”, with a separate route “For offline devices”. We didn’t check what the tool sends.
- Its manager opens from the notification, the Action button or the dialer code
*#*#5776733#*#*. Version 2.0.1 removed the home screen shortcut.
Enable a module
Modules are ordinary APKs.
- Install the module’s APK, for example Global Icon Pack or HideMockLocation. The framework notifies you that it is “installed, but is not activated yet”.
- In the manager, open Modules and enable it.
- Choose its scope: the apps the module is allowed to hook. A module does nothing outside its scope. Many modules suggest one, which Vector offers as “Use what the module asks for”; system-wide modules usually need System Framework. With no apps selected, Vector warns: “This module is enabled but has no apps selected, so it will not do anything.”
- Restart what it hooks. For apps in scope, force-stop them and open them again; in Vector’s words, “Each app picks this up the next time it starts.” If System Framework is in scope, reboot the phone, or use Vector’s Soft reboot, which restarts the framework without rebooting: “Every running app closes and the screen goes black for a moment.” The same applies when a module updates: the framework’s notification says whether to force-stop the apps or reboot.
When a module doesn’t work
- Check it’s enabled and the scope is right. This is the most common cause. A module that hooks Settings does nothing if only your launcher is in scope.
- Check Zygisk. On Magisk, the framework’s entry in the module list says “Module suspended because Zygisk isn’t enabled”, and its Action button disappears.
- Check the module’s API against your framework (see the table above). Vector names the problem on the module: “built for libxposed API 100”, or “Needs libxposed API …, which this framework does not provide.”
- Re-optimize the target app. Android may have compiled away the code a module hooks. Vector’s Re-optimize action “Recompiles the app so ART stops inlining the methods a module needs to hook”.
- Don’t use KernelSU’s own soft reboot with Vector. An open report (issue #878) found that it starts a second copy of Vector’s service and nothing gets injected; the developer’s advice for now is “to avoid soft-reboot from KernelSU”. A full reboot works, and so does Vector’s own Soft reboot.
- Check the module supports your phone. Many modules target specific Android versions or manufacturer skins, and the module’s own page says which. After a system update, check for a new module release before rebooting.
- Logs for both Vector and LSPosed are in
/data/adb/lspd/log.
If the phone won’t start
Vector has no safe mode of its own. Use your root solution’s, which disables every module, the framework included:
- Magisk: with USB debugging on, run
adb shell magisk --remove-modules, which removes all modules and reboots. Without it, Magisk’s safe mode: press volume down a few seconds before the boot animation and release it when the animation appears. Our root guide has the details. - KernelSU: after the first boot screen, press and release volume down more than three times. With adb and root,
ksud module disable <module id>. - APatch: its documentation describes its own key sequence for safe mode.
LSPosed 2.x has a safe mode of its own for repeated System UI crashes, added in 2.0.1 and refined since; version 2.2.1 added a setting to switch it off.
Switching between LSPosed and Vector, or uninstalling
- They share one settings folder. LSPosed and Vector both keep their module list and scopes in
/data/adb/lspd, and the uninstall script of each deletes that folder. - Installing Vector doesn’t remove LSPosed. Its installer only disables an existing LSPosed module (“LSPosed installation detected, disabling it for Vector”). Removing LSPosed afterwards runs LSPosed’s uninstall script, which would most likely delete the shared folder that Vector now uses too.
- So switch in this order: back up your modules (Vector’s Back up modules saves the modules and their scopes), remove the old framework in your root manager, reboot, install the new one, then restore.
- To uninstall either one, remove its module in your root manager and reboot. Module APKs are ordinary apps and stay installed until you uninstall them. If you used Vector’s Install as an app, uninstall that app as well.
The LSPosed modules list has nine open-source modules, each checked for the Xposed API and scanned for trackers.
Apps in this guide
-
Disable Target API Block Lifts the block Android 14 and later put on installing apps built for very old Android versions, for every install method.Download -
HideMockLocation Hides an active mock location from the apps you choose, so they stop refusing to work.Download -
Global Icon Pack Applies your icon pack across all of Android, including Settings, Recents and other screens a launcher can’t reach.Download -
Pengeek A large set of system tweaks for Xiaomi phones on HyperOS, and the successor to CustoMIUIzer.Download -
Free Notifications Makes every notification channel editable again, including locked system ones like the Developer options notice.Download
-
NoStorageRestrict Lets apps pick the Download and Android folders through the system folder picker again, which Android 11 blocked.Download
-
KnoxPatch Gets Samsung apps and features working again on a rooted Galaxy phone by hooking the checks that fail after rooting.Download
Sources
- LSPosed README and releases (open source, last release v1.9.2) checked Oct 18, 2026
- LSPosed official website (links to lsposed.zip) checked Oct 18, 2026
- LSPosed channel: v2.2.1 release notes checked Oct 18, 2026
- LSPosed channel: internal testing without source code (April 2024) checked Oct 18, 2026
- Vector README, v2.2 checked Oct 18, 2026
- Vector releases (v2.0 rename, v2.1 libxposed API 101, v2.2) checked Oct 18, 2026
- Vector source: which module APIs it loads (FileSystem.kt, v2.2) checked Oct 18, 2026
- Vector issue #878: no injection after a KernelSU soft reboot checked Oct 18, 2026
- KernelSU FAQ (Xposed and Zygisk) checked Oct 18, 2026
- KernelSU: rescue from bootloop checked Oct 18, 2026
- APatch FAQ (LSPosed and Zygisk) checked Oct 18, 2026
- Magisk FAQ (removing modules after a bootloop) checked Oct 18, 2026
- NeoZygisk checked Oct 18, 2026
- ReZygisk README checked Oct 18, 2026