🌏 README Language: English / 中文 / 日本語
FolkPatch - A Root management tool focused on interface optimization and feature extension
Built on KernelPatch, FolkPatch delivers a stable Root experience along with a brand-new interface and a three-tier extension system: APM / KPM / Plugins. Get started quickly with our comprehensive documentation — installation, module management, plugin development, and personalization, all in one place.
📚 Read Full Documentation →
✨ Introduction
🎨 Core Features
📱 Prerequisites
- Required: ARM64 architecture Android device with Linux kernel version 3.18 to 6.15
🎨 Manager Interface & Design
📦 Modules & Extension System
FolkPatch provides a three-tier extension system covering customization needs from kernel to user space:
🧩 Plugin System (APD Lua Plugin)
Plugins are FolkPatch's lightweight user-space extensions, positioned between APM (system-level modules) and KPM (kernel-level modules): no system file modification, no kernel injection — just Lua scripts running in the apd lifecycle. Unlike traditional modules, plugins take effect immediately after installation without a reboot, and are much easier to develop.
Supported capabilities:
- Enable/disable switch
- Quick actions and user configuration UI
- Scheduled daemon tasks (background polling)
- Persistent execution logs with viewing, exporting and sharing
For the full plugin documentation (package format, API, lifecycle, management commands), see:
⚡ Technical Features
🚀 Download & Install
-
Download:
Get the latest installation package from the Releases page
-
Install:
Install the package on your Android device and follow the in-app guide
-
Get Started:
Read the full documentation for module management, plugin development and more
🙏 Open Source Credits
This project is based on the following open source projects:
- KernelPatch - Core component
- Magisk - magiskpolicy
- KernelSU - App UI and Magisk-like module support
- Sukisu-Ultra - Referenced some interface designs
- APatch - Upstream branch
- MMRL - Module repository data format reference and data source
- Shizuku - Built-in Shizuku service
📄 License
- FolkPatch is open sourced under the GNU General Public License v3 (GPL-3) license. As a modifier or distributor, you must comply with the following standards:
- If you modify the code or integrate FolkPatch into your project and distribute it to a third party, your entire project must also be open sourced under the GPLv3 license
- When distributing binary files, you must actively provide or promise to provide complete and readable source code
- Strictly prohibit charging licensing fees for the software license itself. You may charge for distribution, technical support, or customized development
- Distribution implies that you grant all users the relevant patents involved in the use of the project
- This software is provided "as is", without any warranty. The original author is not responsible for any losses caused by using this software
- Any violation of the above terms will automatically terminate your GPLv3 license. At that time, you will lose the legal right to distribute FolkPatch. The original author reserves the right to pursue copyright infringement liability (including but not limited to applying for injunctions to stop infringement, economic compensation, and removing infringing projects)
FolkPatch Discussion & Communication