ZNNext

A from-scratch, standalone implementation of the Zygisk Next module.

Introduction

A Magisk module that attempts to implement the ZygiskNext API.

A Zygisk Next module is a valid Magisk module. Starting with version v1.2.0—preview1 after the project went closed-source—ZygiskNext introduced support for "ZygiskNext modules." These provide more convenient interfaces for inline and PLT hooking and even support advanced injection into the HyperOS Runtime. Consequently, I created this open-source Magisk module to load those ZygiskNext modules.

Supported Versions

• Android 5.0 - 17 QPR3 Beta1
• Linux 3.17 or newer

or

• GrapheneOS
• Linux 3.17 or newer

Kernel event tracking is optional and uses whatever the kernel provides: tracefs sched_process_exec events first, then the proc connector and eBPF. A /proc polling mode needs no kernel support at all, so any supported kernel works without kernel events.

Install

1. Install Magisk 26402+ or KernelSU 11425+ or APatch 10700+
2. Download and install ZNNext in manager
3. Reboot
4. Have fun :)

Download

• For stable releases, please go to Github Releases page
• For canary build, please check Github Actions

Note: debug builds are only available in Github Actions.

Get Help

Only bug reports from THE LATEST DEBUG BUILD will be accepted.

• GitHub issues: Issues

• (For Chinese speakers) 本项目只接受英语标题的issue。如果您不懂英语，请使用翻译工具

For Developers

Read the ZygiskNextModuleSample

HyperOS Runtime

Look this: hyos_runtime.md

Community Discussion

• Telegram: @EdLSPesodITed

Notice: These community groups don't accept any bug report, please use Get help to report.

Translation Contributing

Create a Pull Request.

Credits

• Magisk: makes all these possible
• ZygiskNext: OG implementation
• Dobby, rv64hook, ShadowHook and And64InlineHook: used for inline hooking
• LSPlt, ByteHook, xHook and PLTI: uesd for plt hooking
• libcxx: libc++/libc++abi statically linked into the loader
• LZMA SDK and xz-embedded: .gnu_debugdata decompressor

License

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