Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bmax121/APatch

The patching of Android kernel and Android system
https://github.com/bmax121/APatch

android inline-hook kernel magisk magisk-module patch root

Last synced: 9 days ago
JSON representation

The patching of Android kernel and Android system

Host: GitHub
URL: https://github.com/bmax121/APatch
Owner: bmax121
License: gpl-3.0
Created: 2023-08-21T14:20:01.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2024-10-29T03:50:43.000Z (11 days ago)
Last Synced: 2024-10-29T15:37:56.519Z (10 days ago)
Topics: android, inline-hook, kernel, magisk, magisk-module, patch, root
Language: Kotlin
Homepage:
Size: 16.9 MB
Stars: 4,502
Watchers: 68
Forks: 338
Open Issues: 64
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        




APatch


[![Latest Release](https://img.shields.io/github/v/release/bmax121/APatch?label=Release&logo=github)](https://github.com/bmax121/APatch/releases/latest)

[![Nightly Release](https://img.shields.io/badge/Nightly%20release-gray?logo=hackthebox&logoColor=fff)](https://nightly.link/bmax121/APatch/workflows/build/main/APatch)

[![Weblate](https://img.shields.io/badge/Localization-Weblate-teal?logo=weblate)](https://hosted.weblate.org/engage/APatch)

[![Channel](https://img.shields.io/badge/Follow-Telegram-blue.svg?logo=telegram)](https://t.me/APatchGroup)

[![GitHub License](https://img.shields.io/github/license/bmax121/APatch?logo=gnu)](/LICENSE)



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](https://github.com/bmax121/KernelPatch/).

- The APatch UI and the APModule source code have been derived and modified from [KernelSU](https://github.com/tiann/KernelSU).

[](https://f-droid.org/packages/me.bmax.apatch/)

Or download the latest APK from the [Releases Section](https://github.com/bmax121/APatch/releases/latest).

## 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](https://hosted.weblate.org/engage/apatch/). PR of APatch translation is no longer accepted, because it will conflict with Weblate.



[![Translation Status](https://hosted.weblate.org/widget/APatch/open-graph.png)](https://hosted.weblate.org/engage/APatch/)



## Get Help

### Usage

For usage, please refer to [our official documentation](https://apatch.dev).  

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](https://github.com/AndroidPatch/APatchDocs) in other languages.

### Updates

- Telegram Channel: [@APatchUpdates](https://t.me/APatchChannel)

### Discussions

- Telegram Group: [@APatchDiscussions(EN/CN)](https://t.me/Apatch_discuss)

- Telegram Group: [中文](https://t.me/APatch_CN_Group)

### More Information

- [Documents](docs/)

## Credits

- [KernelPatch](https://github.com/bmax121/KernelPatch/): The core.

- [Magisk](https://github.com/topjohnwu/Magisk): magiskboot and magiskpolicy.

- [KernelSU](https://github.com/tiann/KernelSU): App UI, and Magisk module like support.

## License

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