JingMatrix/Vector

---

Introduction

Vector is a Zygisk module providing an ART hooking framework that maintains API consistency with the original Xposed. It is engineered on top of LSPlant to deliver a stable, native-level instrumentation environment.

The framework allows modules to modify system and application behavior in-memory. Because no APK files are modified, changes are non-destructive, easily reversible via reboot, and compatible across various ROMs and Android versions.

---

Compatibility

Vector supports devices running Android 8.1 through Android 17 Beta.

[!TIP]

This framework requires a recent installation of Magisk or KernelSU with Zygisk enabled.

---

Installation

1. Download the latest release as a system module. 2. Install the module via your root manager (Magisk/KernelSU). 3. Ensure a Zygisk environment (e.g., NeoZygisk). 4. Reboot the device. 5. Access management settings via the system notification.

---

Downloads

| Channel | Source | | :--- | :--- | | Stable Releases | GitHub Releases | | Canary (CI) Builds | GitHub Actions |

[!NOTE]

Debug builds are recommended for users encountering issues or performing troubleshooting.

We encourage users to test CI builds to help us identify bugs and accelerate development.

[!CAUTION]

GitHub requires users to be logged in to download CI artifacts.

> The link above is filtered to show only master branch builds.

Please note that builds from Pull Requests (PRs) are often unstable and potentially unsafe (depending on the authors); we recommend staying on the master branch for verified builds, unless you are asked to help our debugging sessions.

---

Support and Contribution

If you encounter issues or wish to help improve the project, please refer to the resources below.

• Troubleshooting: Consult the guide before reporting bugs.
• Discussions: Join our community on GitHub Discussions.
• Localization: Help translate the project via Crowdin.

[!IMPORTANT]

Bug reports are only accepted if they are based on the latest debug build.

> Notice for Chinese speakers:

> 为了提高沟通效率，本项目仅接受英文 Issue。请使用 DeepL 或其他翻译工具提交您的反馈。

---

Developer Resources

Vector supports both legacy and modern hooking standards to ensure broad module compatibility.

• Legacy Xposed API
• Modern libxposed API
• Xposed Module Repository

[!NOTE]

Vector supports the libxposed API via two git submodules: the module API and the service API.

> A successful GitHub Actions build of the master branch indicates that Vector fully supports these APIs at those specific commits.

Developers are suggested to check out the same commits as Vector.

---

Credits

This project is made possible by the following open-source contributions:

• Magisk: The foundation of Android customization.
• LSPlant: The core ART hooking engine.
• XposedBridge: The standard Xposed APIs.
• Dobby: Inline hooking implementation.
• LSPosed: Upstream source.
• EdXposed: Upstream source, before LSPosed.
• xz-embedded: Library decompression utilities.

---

License

Vector is licensed under the GNU General Public License v3.