⚠️ This is a fork of the original APatch project.

⚠️ This is a simplified version which uses an HARDCODED SUPERKEY for the kernel super calls. You may consider this as non-secure for your use cases so consider yourself warned!

⚠️ If you intend to use the official version, please go to the official APatch project page to download an official release package.

I made this fork with simplicity and an easy-to-use UI in mind for my daily usage of a simple SuperUser management app with OverlayFS support. These are the differences compared with the original version:

• Hardcoded superkey for simplicity
• Simplified patching UI
• No KPM management

---

APatch

The patching of Android kernel and Android system.

• A new kernel-based root solution for Android devices.
• APM: Support for modules similar to Magisk.
• KPM: Support for modules that allow you to inject any code into the kernel (Requires kernel function inline-hook and syscall-table-hook enabled).
• APatch relies on KernelPatch.
• The APatch UI and the APModule source code have been derived and modified from KernelSU.

Or download the latest APK from the Releases Section.

Supported Versions

• Only supports the ARM64 architecture.
• Only supports Android kernel versions 3.18 - 6.1

Support for Samsung devices with security protection: Planned

Requirement

Kernel configs:

• CONFIG_KALLSYMS=y and CONFIG_KALLSYMS_ALL=y

• CONFIG_KALLSYMS=y and CONFIG_KALLSYMS_ALL=n: Initial support

Security Alert

The SuperKey has higher privileges than root access.
Weak or compromised keys can lead to unauthorized control of your device.
It is critical to use robust keys and safeguard them from exposure to maintain the security of your device.

Translation

To help translate APatch or improve existing translations, please use Weblate. PR of APatch translation is no longer accepted, because it will conflict with Weblate.

Get Help

Usage

For usage, please refer to our official documentation.
It's worth noting that the documentation is currently not quite complete, and the content may change at any time.
Furthermore, we need more volunteers to contribute to the documentation in other languages.

Updates

• Telegram Channel: @APatchUpdates

Discussions

• Telegram Group: @APatchDiscussions(EN/CN)
• Telegram Group: 中文

More Information

• Documents

Credits

• KernelPatch: The core.
• Magisk: magiskboot and magiskpolicy.
• KernelSU: App UI, and Magisk module like support.

License

APatch is licensed under the GNU General Public License v3 GPL-3.