Repository navigation
WhatsApp Clone Tool v3.0.0 - Universal Zero-Dependency Suite
Overview
Version 3.0.0 introduces a comprehensive overhaul of the WhatsApp Clone Tool. It features an automated end-to-end pipeline, split APK bundle merging, a bundled cross-platform JAR tools suite, interactive touch/mouse/keyboard navigation, dedicated distribution directory routing, and automated tool release checking.
Key Features & Improvements
1. Automated End-to-End Pipeline
- Direct input support for
.apkfiles:python whatsapp_clone.py base.apk --mode 2 --package mywa --name MyWA. - Automatically executes decompilation, bytecode remapping, XML updates, bitwise 1:1 repack, and 4-byte zipalign in a single unified execution.
2. Split APK & App Bundle Merge Engine (.apkm, .xapk, .apks)
- Built-in support for APKMirror (
.apkm), APKPure/Combo (.xapk), Bundletool (.apks), and split APK directories. - Utilizes
APKEditor.jarto merge architecture native libraries (arm64-v8a, armeabi-v7a), display density splits, and localized language resources into a standalone APK. - Supports standalone bundle merging via the
--merge-onlyflag.
3. Bundled Cross-Platform Tools Suite (Android Build-Tools v37.0.0)
- Bundles pure Java binaries inside
./tools/:apktool.jar(v3.0.3)apksigner.jar(Android SDK Build-Tools v37.0.0)APKEditor.jar(v1.4.9)d8.jar(Android SDK Build-Tools v37.0.0)
- Zero external configuration required on Windows, Linux, macOS, and Android (Termux).
- Auto-discovery prioritized in
ToolConfig.find_tool().
4. GitHub Releases Tool Updater
- In-memory version checking against official upstream repositories (
iBotPeaches/ApktoolandREAndroid/APKEditor). - Stream downloader with real-time progress indicators (size downloaded, transfer rate, ETA).
- Accessible via
--check-toolsand--update-toolsCLI flags or the interactive menu.
5. Touch Screen, Mouse Click & Keyboard Navigation
- Standard ANSI SGR 1006 mouse tracking support for touch screen taps (Termux Android) and mouse clicks (VSCode / Windows Terminal).
- Complete keyboard controls including Arrow keys, Vim keys (
j/k), numeric shortcuts (1-9), andEnter.
6. Build-Only Fast Packaging Mode
- Fast-path execution for existing decompiled directories (
--build-only/ Mode 4). - Bypasses Dalvik bytecode and XML processing to directly recompile and repack modified projects.
7. Dedicated Distribution Directory & Automated Cleanup
- Cloned APKs are output to
./dist/(dist/<package>_ExactZip_cloned.apk). - Temporary staging directories (
.build/) and intermediate unsigned files are automatically removed upon successful build.
8. Core Bytecode & Manifest Remapping Engine
- Remaps 11+ Content Provider authorities (
accountswitching,mlkitinitprovider,orbitmessages, etc.) preventingINSTALL_FAILED_CONFLICTING_PROVIDER. - Remaps custom defined permissions preventing
INSTALL_FAILED_DUPLICATE_PERMISSION. - Whitelist protection prevents official Meta/WhatsApp submodules from namespace collisions.
- 1:1 direct-copy exact ZIP repack engine with in-place DEX & manifest injection and 4-byte zipalign.
Command Line Reference
| Argument / Flag | Description |
|---|---|
folder_or_apk |
Root decompiled directory, .apk file, or split bundle (.apkm, .xapk, .apks) |
--whatsapp-type INT |
1 = Standard WhatsApp, 2 = Business, 3 = Custom/Auto |
--mode INT |
1 = Auto, 2 = Custom Package, 3 = Custom ALL, 4 = Build-Only |
--package STRING |
New package name without com. prefix |
--name STRING |
New storage folder name |
--build |
Recompile and repack final cloned APK |
--build-only |
Skip cloning and repack decompiled folder directly |
--merge-only |
Merge split bundle into standalone APK and exit |
--out-dir DIR |
Output directory for finished APKs (Default: dist) |
--sign |
Sign output APK with apksigner (Default: unsigned) |
--check-tools |
Check GitHub releases for tool updates |
--update-tools |
Automatically update tool JARs to latest releases |
--clean |
Force clean re-decompilation if folder exists |