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

[!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.

Legacy and Historical Dependencies

• Riru
• SandHook
• YAHFA
• dexmaker
• DexBuilder

---

License

Vector is licensed under the GNU General Public License v3.