well, I have to admit that AI is much better at writing readme.md than me LOL
An automated kernel patching tool for vivo / iQOO devices running Linux 4.x kernels.
This tool is designed to simplify the process of patching restricted kernels so that Magisk and root solutions can function properly.
👉 Downloads:
GitHub Releases
Modifying a device kernel is inherently dangerous.
Incorrect patching may result in a hard brick.
If you:
- do not fully understand what this tool does, or
- believe the tool may contain malware, or
- are unwilling to accept the risks
DO NOT USE THIS TOOL.
You have been warned.
(For legacy)
- Windows 10 (x64) / 11
- Android 9+
(For CSharp release/debug)
- Windows XP x86/x64 (with OCA) +
- .net 4.0.30319
- Android 9+
| Kernel Version | 4.9.77+ | 4.14.94+ | 4.14.98 | 4.14.141+ | 4.14.186 | 4.14.190 | 4.19.191+ |
|---|---|---|---|---|---|---|---|
| Status | ❓³ | ❓ | ❓ | ✔️ | ✔️¹² | ❓¹ | ✔️¹² |
- ✔️ Tested and working
- ❓ Needs more user feedback
- ❌ Failed
Notes:
- Mount fix caused a bootloop
vivo do_mount_checkpatch required- Works normally on Android 9 and above
👉 Feedback welcome:
#1
✔ Automatically unpack boot.img
✔ Automatically extract and patch kernel
✔ Automatically repack boot.img
- Automatically detects Linux kernel major version
- Warns user if kernel is not 4.x
- Automatically decompresses compressed kernels
- Mount fix patch is optional
- Optional patch for
/system → /syswxl
required for Magisk on some models
This tool is feature-complete and no longer under active development (except debug).
- This tool ONLY patches the kernel
- It does NOT fix issues caused by:
- SELinux
- init scripts
- vendor framework restrictions
- non-kernel components
If the patch does not work for your device, consider using Magisk SUU instead.
fxxk you vivo, fxxk you bbk, look at what you've done
For release:
csc /optimize+ /out:main.exe main.cs
csc /optimize+ /out:patch.exe patch.cs
For Debug:
csc /define:DEBUG /optimize- /debug /out:main.exe main.cs
csc /define:DEBUG /optimize- /debug /out:patch.exe patch.cs
(Use ps2exe)
ps2exe -inputfile main.ps1 -outputfile main.exe
ps2exe -inputfile patch.ps1 -outputfile patch.exe
During execution, this tool will:
- Unpack boot.img
- Generate temporary kernel files
- Create multiple temporary files
- Automatically clean up the current directory after completion
Therefore:
Please run this tool ONLY inside an independent temporary folder!
For example:
D:\temp\
C:\Users\xxx\Desktop\temp\
......
Do NOT:
- Run it directly from the desktop
- Run it inside a directory containing important files
- Run it from the system drive root directory
- Run it directly inside the downloads folder
Otherwise, important files in the current directory may be accidentally deleted!
- romanovj — kernel restriction solutions (su, mount fix)
- wuxianlin —
do_mount_checkpatch - radare2 — reverse engineering framework
- Magisk — boot image unpacking and repacking
- LoveRedscholar
& Nevoraa — multi-device testing vivo Open Source — useless shit
This project does NOT provide or distribute any proprietary exploits, confidential information, or undisclosed vulnerabilities.
All patching methods used by this tool are:
- Publicly known
- Independently researched
- Previously published in open communities
This project merely automates an existing manual process using publicly available tools and techniques.
The author:
- Does not claim ownership of the underlying methods
- Does not bypass any server-side or account-based protections
- Does not provide any commercial service
This tool is provided for research and educational purposes only.
Users are solely responsible for:
- How they use this tool
- Any damage to their devices
- Any legal consequences resulting from misuse
If this project violates any policy or local regulation, please open an issue for discussion.