Install / Use
About 1195 wordsAbout 4 min
2025-08-16
🎯 This guide will help you install and use FolkPatch from scratch, easy even for beginners!
🔍 Basic Knowledge
What is FolkPatch?
FolkPatch is a fork of APatch, focusing on optimizing interface design and function expansion, without introducing new core functions.
🛠️ Preparation
- A phone with unlocked Bootloader
- A computer with ADB tools
- Your phone kernel supports KernelPatch
📱 Check Device Compatibility
Supported Device Types
✅ Supported Devices:
- ARM64 architecture (Most Android phones in recent years)
- Android kernel version 3.18 - 6.6
❌ Unsupported Devices:
- Non-ARM64 architecture devices (some old tablets)
- Kernel version lower than 3.18 or higher than 6.6
How to Check Kernel Version?
Method 1: Phone Settings
- Settings → About Phone → Software Information → Kernel Version
Method 2: Use ADB Command
adb shell uname -r
How to Check Kernel Configuration (Root Required)
If your phone is already Rooted, you can use the following command to check the kernel configuration:
zcat /proc/config.gz | grep CONFIG_KALLSYMSShould display:
CONFIG_KALLSYMS=y
CONFIG_KALLSYMS_ALL=yOr
CONFIG_KALLSYMS=y
CONFIG_KALLSYMS_ALL=nHint
If either of the above configurations is displayed, your device supports FolkPatch.
📁 Get Necessary Files
Get Boot Image
From Official Firmware Package
- Download the official firmware corresponding to your phone model
- Unzip and find the
boot.imgfile - Copy to computer for backup
Extract from Current Device
# Requires ADB permission adb pull /dev/block/by-name/boot ./boot.img
Backup Boot Image
Important
Be sure to backup the original boot.img image!
This file is an important guarantee for restoring the system. If there is a problem such as failure to boot, you need it to repair the phone!
🚀 Install FolkPatch
Method 1: Official Tool One-Click Flash (Highly Recommended)
This is currently the most convenient installation method. The official FolkTool supports one-click flashing without complex operations.
For detailed tutorial, please refer to: FolkTool Usage Guide
- Download Tool: Visit FolkTool Release Page to download the latest version of the tool.
- Connect Device: Ensure your phone has USB debugging enabled and is connected to the computer.
- One-Click Flash: Run the tool and follow the interface instructions to automatically complete the flashing.
Method 2: Automatic Patching (Recommended for Beginners)
This is the simplest and safest method, suitable for most users.
Step 1: Install FolkPatch Manager
- Download and install FolkPatch Manager APK on your phone
- Allow "Install apps from unknown sources"
Step 2: Patch Boot Image
- Open FolkPatch Manager
- Click the patch button in the upper right corner 🛠️
- Select "Select a boot image and patch"
- Find and select the
boot.imgfile you prepared
Step 3: Set Superkey
- Set a password in the "Superkey" card
- This will be your password to get Root permission, please remember it!
- ⚠️ Weak passwords are prohibited (such as 12345678), the system will require a complex password
注意
Please be sure to remember your Superkey, which ensures your control over Root permissions.
Step 4: Finish Patching
- Click "Start Patching" and wait for completion
- After successful patching, the path of the patched image will be displayed, for example:
/storage/emulated/0/Download/folkpatch_xxxx.img
Continue reading the "Flash Image" section below to complete the installation.
Method 3: Manual Patching (For Advanced Users)
When KernelPatch is updated but the manager is not yet updated, you can use this method.
Step 1: Download Tools
- Visit KernelPatch Release Page
- Download the following files:
kptools-win.zip(Windows users) orkptools-linux(Linux users)kpimg-androidmagiskboot(corresponding system version)
Step 2: Unpack Boot Image
# Windows Users
magiskboot.exe unpack boot.img
# Linux Users
./magiskboot unpack boot.imgStep 3: Patch Kernel
# Windows Users
kptools-x86_64-win.exe -p --image kernel-b --skey "YourKey" --kpimg kpimg-android --out kernel
# Linux Users
./kptools-linux -p --image kernel-b --skey "YourKey" --kpimg kpimg-android --out kernelStep 4: Repack
# Windows Users
magiskboot.exe repack boot.img
# Linux Users
./magiskboot repack boot.imgAfter completion, you will get a file named new-boot.img, which is the patched image.
Alternative
You can also use the Online Patching Tool, just upload the Boot image to automatically complete the patching.
📲 Flash Image (For Method 2 and Method 3)
Preparation
- Ensure USB debugging is enabled on the phone
- Copy the patched image to the computer
- Connect phone and computer
Start Flashing
Step 1: Enter Fastboot Mode
adb reboot bootloaderStep 2: Flash Patched Image
# Replace PATH/TO/boot.img with the actual path of your patched image
fastboot flash boot PATH/TO/boot.imgStep 3: Reboot Device
fastboot rebootTip
If you are not sure if the flashing is successful, you can first use the following command to boot temporarily:
fastboot boot PATH/TO/boot.imgThis way, if the system cannot start normally, just restart the phone to restore the original state.
✅ Post-Install Operations
Verify Root Permission
- Install Root permission detection app (such as Root Checker)
- Open the app and check if "Root permission obtained" is displayed
Use Root Apps
- Open an app that requires Root permission
- FolkPatch will pop up a permission request
- Select "Allow" and enter your Superkey
Install Module Support
- Open FolkPatch Manager
- Enter "Modules" page
- You can download and install various functional modules
Use Module Scripts
Many modules contain scripts that run automatically, which can perform specific tasks when the system starts:
- service.sh - Executed late in system boot, suitable for most scenarios
- post-fs-data.sh - Executed after file system mount (blocking, use with caution)
- boot-completed.sh - Executed after system boot is complete
How to view and manage scripts:
- View Scripts: Enter the module details page, click "Browse Module Files"
- Execute Action: If the module supports it, click the "Execute Action" button to run specific scripts
- View Logs: Script logs are usually saved in the
/data/local/tmp/directory
Learn more:
- 📥 Script Import Tutorial - How to import custom scripts
- ⚙️ Script Management Guide - Complete guide to managing scripts
- 💡 Script Examples - Common script example code
🗑️ Uninstall FolkPatch
Method 1: Uninstall using FolkPatch Manager
- Download the FolkPatch installation package identical to your current version
- Rename the file, add
-uninstall, for example:FolkPatch-10888-release.apk→FolkPatch-10888-release-uninstall.zip - Transfer the file to the phone and flash it via Recovery
提示
Similarly, like installation, uninstallation also supports using adb sideload.
Method 2: Manually Flash Back Original Boot Image
Put the phone into Fastboot mode:
adb reboot bootloaderFlash back your previously backed up original Boot image:
fastboot flash boot PATH/TO/original_boot.imgReboot phone:
fastboot reboot
Important Reminder
Never flash the init_boot file, it will only cause the system to fail to boot!
🎉 Complete
Congratulations! You have successfully installed FolkPatch. Now you can freely explore more possibilities of the Android system!
Remember to abide by the principle of "Safe Flashing":
- Only install apps and modules from reliable sources
- Regularly backup important data
- Do not modify critical system files at will
Enjoy your Root journey! 🚀
Some materials cited from APatch Documentation
Copyright
Copyright Ownership:FolkPatch Team
License under:Attribution 4.0 International (CC-BY-4.0)
