Releases: nach0-bit/universal-mtk-vbmeta-patcher
Release list
v3.1.0 - hot fix 1🔧
🚀 Universal MTK VBMeta Patcher leaps into a new generation!
This major release officially deprecates the legacy Windows Batch (.bat) script due to architecture limitations, unifying the entire engine under a universal, cross-platform Python 3 codebase.
🔧 What's New in v3.1.0 (Hotfix 1):
- [HOTFIX] Zero-Setup Dependencies: Fixed an issue where missing modules caused the script to crash. The engine now automatically detects and installs required Python modules (like
cryptography) on its first run. No moreModuleNotFoundError! - The Universal Standard: One script to rule them all. Full parity and flawless execution on both Windows (LTSC/Standard) and GNU/Linux.
- Smart A/B Detection: The engine now automatically queries the device slot layout and deploys
--slot allsafely when dual slots are found. - Deep Metadata Flush: Implemented a secure
fastboot erase metadatachain with a structuralformat:ext4fallback to forcefully eliminate MTK dm-verity bootloops. - Bonus Root Injection: If a
boot.img(Magisk/APatch) is detected in the working directory, the script offers to flash it automatically to complete the root sequence. - Refined Terminal UI: Color-coded status updates and isolated
avbtool_log.txtoutputs for seamless auditing.
Developed with 💻 by N.dev (@nach0-bit)
v3.1.0 - The Python Era: Dynamic Slot Detection, Deep Erase & Root Helper
🚀 Universal MTK VBMeta Patcher leaps into a new generation!
This major release officially deprecates the legacy Windows Batch (.bat) script due to architecture limitations, unifying the entire engine under a universal, cross-platform Python 3 codebase.
🔧 What's New in v3.1.0:
- The Universal Standard: One script to rule them all. Full parity and flawless execution on both Windows (LTSC/Standard) and GNU/Linux.
- Smart A/B Detection: The engine now automatically queries the device slot layout and deploys
--slot allsafely when dual slots are found. - Deep Metadata Flush: Implemented a secure
fastboot erase metadatachain with a structuralformat:ext4fallback to forcefully eliminate MTK dm-verity bootloops. - Bonus Root Injection: If a
boot.img(Magisk/APatch) is detected in the working directory, the script offers to flash it automatically to complete the root sequence. - Refined Terminal UI: Color-coded status updates and isolated
avbtool_log.txtoutputs for seamless auditing.
Developed with 💻 by N.dev (@nach0-bit)
v3.0.0 - Cross-Platform Python Engine & Auto-Boot Root Helper
What's New in v3.0.0 🚀
This is the biggest architectural overhaul yet. The project has evolved from a simple Windows script into a Universal Dual-Engine Suite, making it completely cross-platform and adding native automated routing support.
🛠️ New Features & Improvements
- Python Engine Integration (
.py): Added a pure Python 3 implementation. The tool is now fully compatible with Linux and macOS natively, utilizingshutil.whichfor cleaner dependency resolution. - Native Windows Batch Engine (
.bat): Kept and optimized the classic standalone script for Windows users who prefer a zero-dependency, double-click execution setup. - [BONUS] Auto-Boot Root Helper: The suite now automatically scans your directory for a
boot.img(stock or pre-patched via Magisk/APatch). If detected, it offers a safe, one-click prompt to flash it right after disabling AVB. - Dynamic A/B Slot Tracking: Automated hardware checking natively queries
slot-countto flash both slots (--slot all) seamlessly on modern dual-slot systems. - Failsafe Interrupts & Logging: Added granular
KeyboardInterrupthandling to safely abort flashing routines without crashing, alongside direct console log dumping ifavbtoolfails.
📦 Which file should I use?
- Windows users: Simply download and double-click
mtk_vbmeta_patcher.bat. - Linux / macOS users: Open your terminal in the directory and run
python3 mtk_vbmeta_patcher.py.
Huge thanks to the community for the continuous feedback and device testing reports! If this update saved your device, don't forget to drop a 🌟 on the repo!
v2.1.0 - Add MTK hardware validation, native A/B partition flashing, and robust fail-safes
A production-ready Windows batch utility to safely disable AVB verification on MediaTek devices. Features dynamic hardware validation, explicit A/B slot partition flashing, and advanced error handling.
[UPDATE v2.0.0] Pack completely rewritten for stability! 🚀
What's new in this version:
Fixed fastboot syntax: Corrected metadata wipe command to avoid silent errors.
Added A/B Slot Detection: The script now checks your device automatically and flashes both slots if needed (--slot all).
Safer Error Handling: If a flash step fails, the script stops immediately to protect your device from loops.
Better Logs: Added automated dependency checks (Python/Fastboot PATH) and error logs to debug avbtool.py issues easily.
Just extract and run the new .bat file with your device in Fastboot mode!
v1.1.0 - Enhanced Performance Release
🚀 v1.1.0 - Architecture Optimization & Robustness Update
This release introduces a major refactor to the batch execution logic, upgrading the script into a professional, highly compatible automation utility for modern MediaTek devices.
Key Improvements:
• Developer Aesthetics: Implemented a technical terminal interface matrix color scheme (Green on Black) for a premium user experience.
• Maintenance Cleanliness: Modularized core variables (image and script names) into global configuration flags.
• Streamlined UX: Enforced quiet execution on internal tool outputs to present a perfectly clean step-by-step progress tracker.
• Smart Partition Overrides: Integrated error redirection bypasses for 'vbmeta_system' and 'vbmeta_vendor' partitions, ensuring full backwards compatibility with legacy dynamic partition layouts.
• Dynamic Anti-Bootloop Fallback: Upgraded the crypto metadata wipe sequence with a logical OR operator (||)—if direct erasure fails due to strict MTK preloader policies, the script automatically falls back to forced ext4 formatting.
v1.0.0 - Initial Stable Release
Initial universal release of the MTK VBMeta Patcher script including avbtool and automated factory reset functionality