Orchestrates JADX, CFR, Procyon and Vineflower to decompile Android APK/AAB/XAPK/APKS files, with hidden DEX extraction, deobfuscation, signed APK rebuild, ELF analysis and a local REST API.
Aquadecomp is an Android application decompilation platform that integrates multiple decompilers into a fallback chain, maximizing decompiled code coverage, even in obfuscated apps.
decompile runs a single flow with all stages connected:
recovery package)new String(new byte[]{...}), new String(Base64.decode("..."))) without altering the rest of the codejavac, distinguishing syntax errors from dependency resolution errorssources/; modified files keep a .bak copyInstead of relying on a single tool, Aquadecomp uses a multi-engine chain:
The rescue engines receive the APK converted to JAR with dex2jar and only process the classes missing from sources/, thus improving coverage without repeating work.
Result: more classes recovered than with JADX alone, with the primary engine maintaining the quality of the rest of the code.
Aquadecomp does not reimplement decompilers: it integrates existing tools (JADX, CFR, Procyon, Vineflower, dex2jar, baksmali/smali, d8 and apksig) into a single chain with stopping criteria, fallback, analysis and verification. The value of the project lies in that orchestration: recovery of the missing classes, analysis of results, signature verification and reconstruction of the APK.
The report indicates the engine that generated each file: confidence.classes[].decompiler stores the label per file and confidence.decompilerStats summarizes how many files each engine produced. The label is metadata, it does not enter into the score calculation.
The main flow calculates an effectiveness score from 0-100 with four dimensions:
The detail is output in aquedecomp-report.json (effectiveness) and in the Markdown report.
The verification package also calculates a score per class with levels (Excellent/Good/Acceptable/Poor/Unreliable), which is included in the report under confidence.
base/dex/ are read and, if the binary manifest does not exist, the XML decoded by JADX is usedbase.apk) is extracted for inspection, manifest and rescuebase-master.apkAll four formats are validated in the normalization stage; a file that is not a valid ZIP, that does not contain Android content or that has an unknown extension is rejected with a clear message and an error report that is still generated.
rebuild - recompiles the decompiled sources and generates a signed APK with the applied changes (v1+v2+v3 signing with its own certificate: installing it requires uninstalling the previous app); detects aquedecomp-mapping.txt to restore the classpath and rename the dex to the original names (see docs/REBUILD.md)--mapping - applies ProGuard/R8 mappings when decompiling to recover classes and members with their original names (see docs/REBUILD.md)serve - local REST API with JSON to decompile, inspect, extract hidden DEX files, recompile, analyze natives and infer names over HTTP (see docs/API.md)natives - real ELF analysis of the package's .so files (sections, exports, imports, dependencies) with optional Ghidra disassembly if installed (see docs/NATIVES.md)nombres - heuristic name suggestions for obfuscated identifiers, report only, without modifying code (see docs/NAME_INFERENCE.md)unpack - extracts the hidden DEX files from a packed APK with static analysis (assets, libs and ZIP/zlib payloads) and repackages the APK with them at the root; decompile runs it automatically when there is no DEX at the rootapkid - identifies packers, protectors and compilers with APKiD (YARA rules on each file in the APK)bundle - converts an AAB into an APKS file with bundletool in universal modesimplify - deobfuscates an APK with Simplify: runs the dex in a smali virtual machine and rewrites the methodsdeobfuscator - deobfuscates an APK with java-deobfuscator: detects the obfuscator (Zelix, Stringer, Allatori, DashO…), decrypts strings in an isolated sandbox and repackages the signed APKmerge - merges split APKs into a single APK with APKEditor (accepts a folder, .apks, .xapk and .apkm)The bundletool, Simplify, java-deobfuscator and APKEditor jars are downloaded only
once to ~/.aquadecomp with SHA-256 verification and can be replaced with the
AQUADECOMP_BUNDLETOOL, AQUADECOMP_SIMPLIFY,
AQUADECOMP_DEOBFUSCATOR and AQUADECOMP_APKEDITOR variables; APKiD is located in the PATH
or specified with AQUADECOMP_APKID. Details in docs/USAGE.md.
The GitLab pipeline builds aquedecomp.jar on every push to main, along
with its checksum aquedecomp.jar.sha256. Both are downloaded from the latest
green pipeline: