FolkPatch

English

简体中文

English

简体中文

Appearance

Installation/Usage

About 986 wordsAbout 3 min

2025-08-16

🎯 This guide will help you install and use FolkPatch from scratch. Even if you're a flashing beginner, you can easily get started!

🔍 Basics

What is FolkPatch?

FolkPatch is a fork of Apatch, focused on optimizing interface design and feature extensions. It does not introduce new core features.

🛠️ Prerequisites

  • A phone with unlocked Bootloader
  • A computer with ADB tools
  • Your phone's kernel supports KernelPatch

📱 Check Device Compatibility

Supported Device Types

✅ Supported Device Conditions:

  • ARM64 architecture (almost all recent Android phones support this)
  • Android kernel version 3.18 - 6.6

❌ Unsupported Devices:

  • Non-ARM64 architecture devices (some older tablets)
  • Kernel version lower than 3.18 or higher than 6.6

How to check kernel version?

  1. Method 1: Check in phone settings

    • Settings → About Phone → Software Information → Kernel Version

  2. Method 2: Use ADB command

    adb shell uname -r

How to check kernel configuration (requires Root privileges)

If your phone already has Root, you can use the following command to check kernel configuration:

zcat /proc/config.gz | grep CONFIG_KALLSYMS

Should display:

CONFIG_KALLSYMS=y
CONFIG_KALLSYMS_ALL=y

or

CONFIG_KALLSYMS=y
CONFIG_KALLSYMS_ALL=n

Tip

If either configuration above is shown, your device supports FolkPatch.

📁 Obtain Required Files

Get Boot Image

  1. Get from official firmware package

    • Download the official firmware corresponding to your phone model
    • Find the boot.img file after extraction
    • Copy to computer for backup

  2. Extract from current device

    # Requires ADB privileges
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 system recovery. If the phone cannot start and other problems occur, you need this file to repair the phone!

🚀 Install FolkPatch (Two Methods)

This is the simplest and safest method, suitable for the vast majority of users.

Step 1: Install FolkPatch Manager

  1. Download and install FolkPatch Manager APK on your phone
  2. Allow "Install apps from unknown sources"

Step 2: Patch Boot Image

  1. Open FolkPatch Manager
  2. Click the patch button in the upper right corner 🛠️
  3. Select "Select a boot image and patch"
  4. Find and select the boot.img file you prepared

Step 3: Set Superkey

  1. Set a password in the "Superkey" card
  2. This will be the password for you to obtain Root privileges. Please remember it!
  3. ⚠️ Weak passwords are prohibited (such as 12345678). The system will require a complex password to be set

注意

Please remember your Superkey firmly, as this will ensure your control over Root privileges

Step 4: Complete Patching

  1. Click "Start Patching" and wait for completion
  2. After successful patching, the patched image path will be displayed, for example: /storage/emulated/0/Download/folkpatch_xxxx.img

Continue reading the "Flash Image" section below to complete the installation.

Method 2: 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

  1. Visit KernelPatch Release Page
  2. Download the following files:
    • kptools-win.zip (for Windows users) or kptools-linux (for Linux users)
    • kpimg-android
    • magiskboot (corresponding system version)

Step 2: Unpack Boot Image

# Windows users
magiskboot.exe unpack boot.img

# Linux users
./magiskboot unpack boot.img

Step 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 kernel

Step 4: Repack

# Windows users
magiskboot.exe repack boot.img

# Linux users
./magiskboot repack boot.img

After completion, you will get a file named new-boot.img, which is the patched image.

Alternative

You can also use Online Patch Tool, just upload the Boot image to complete patching automatically.

📲 Flash Image

Preparation

  1. Make sure USB debugging is enabled on the phone
  2. Copy the patched image to the computer
  3. Connect phone and computer

Start Flashing

Step 1: Enter Fastboot Mode

adb reboot bootloader

Step 2: Flash Patched Image

# Replace PATH/TO/boot.img with the actual path of your patched image
fastboot flash boot PATH/TO/boot.img

Step 3: Restart Device

fastboot reboot

Tip

If you're not sure whether the flashing was successful, you can use the following command to start temporarily first:

fastboot boot PATH/TO/boot.img

This way, if the system cannot start normally, just restart the phone to restore.

✅ Post-Installation Operations

Verify Root Privileges

  1. Install a root privilege detection app (such as Root Checker)
  2. Open the app and check if it shows "Root privileges obtained"

Use Root Apps

  1. Open an app that requires Root privileges
  2. FolkPatch will pop up a permission request
  3. Select "Allow" and enter your superkey

Install Module Support

  1. Open FolkPatch Manager
  2. Enter the "Modules" page
  3. You can download and install various functional modules

🗑️ Uninstall FolkPatch

Method 1: Uninstall Using FolkPatch Manager

  1. Download the FolkPatch installation package of the same version as your current version
  2. Rename the file, adding -uninstall, for example: FolkPatch-10888-release.apk → FolkPatch-10888-release-uninstall.zip
  3. Transfer the file to the phone and flash it through Recovery

提示

Similarly, like installation, uninstallation also supports adb sideload.

Method 2: Manually Flash Back Original Boot Image

  1. Make the phone enter Fastboot mode:

    adb reboot bootloader

  2. Flash back your previously backed up original Boot image:

    fastboot flash boot PATH/TO/original_boot.img

  3. Restart the phone:

    fastboot reboot

Important Reminder

Never flash the init_boot file, it will only cause the system to fail to start!

🎉 Complete

Congratulations! You have successfully installed FolkPatch. Now you can freely explore more possibilities of the Android system!

Remember to follow the principles of "safe flashing":

  • Only install apps and modules from reliable sources
  • Backup important data regularly
  • Don't arbitrarily modify critical system files

Enjoy your Root journey! 🚀

Part of the material cited from APatch documentation

Copyright Ownership:Cassiopeia

License under:Attribution 4.0 International (CC-BY-4.0)