Technique:Choosing a decompiler
| On this wiki | Facts · Code · Notes · Topics |
|---|
Practical guide to which decompiler to try first for each bytecode or managed format (Python, Lua, Java, Android, .NET, Dart, Hermes, GameMaker, Flash, native code), with licence, documented version coverage and documented failure modes taken from each tool's own README.
How to use this page
Identify the format first (magic bytes, see the linked format pages), then the exact language version, then pick a row. Versions below are what each README says; a blank means the README says nothing and the cell is marked Unverified. Always try a second tool on a function that fails: decompilers fail on different constructs.
Table by input
| Input | Tool | Licence | Versions per its README | Documented failure modes |
|---|---|---|---|---|
| Python .pyc, 1.0 to 3.8 | Tool:Uncompyle6 | GPL-3.0 | 1.0 to 3.8 (tested 1.4, 2.1-2.7, 3.0-3.8) | control flow; weaker away from 3.3-3.4; some magic numbers (3.6) unsupported |
| Python .pyc, 3.7 to 3.8 | Tool:Decompyle3 | Unverified (GPL) | 3.7 and 3.8 | dozens of isolated bugs; released versions only |
| Python .pyc, any version | Tool:Pycdc | GPL-3.0 | aims at all versions, no table | none documented; Unverified: newer opcodes incomplete |
| Python .pyc, 3.6 and later | Tool:PyLingual | GPL-3.0 | all released versions since 3.6 | local build may be less accurate in control flow than the web service; needs the target interpreter to verify |
| Lua 5.1 chunk | Tool:Unluac | Unverified | 5.1 (original README); forks for other builds | needs debug info not stripped |
| Lua 5.2 to 5.4, LuaJIT | luadec, luajit-decompiler | Unverified | Unverified | I could not read these READMEs; see Format:Lua bytecode and Format:LuaJIT bytecode |
| Java .class and jar | Tool:CFR | MIT | modern Java incl. 9, 12, 14 features | none documented |
| Java .class and jar | Tool:Vineflower | Apache-2.0 (per wiki link record) | Java 21+ language features; runs on Java 11 (1.9) or 17 (1.11+) | none documented |
| Java .class | Tool:Procyon | Unverified | decompiler marked experimental | experimental |
| Android APK, dex | Tool:JADX | Apache-2.0 | dex, apk, aab, jar, smali | cannot decompile 100% of code; errors expected |
| .NET assembly | Tool:ILSpy | MIT | assemblies; VS 2022/2026 embed its engine | none documented |
| .NET to debug or patch | Tool:DnSpyEx | GPL-3.0 | .NET Framework, .NET, Unity | dynamic methods cannot be debugged |
| Flutter libapp.so (Dart AOT) | Tool:Blutter | MIT | android arm64, recent Dart only | no Dart source, obfuscated apps incomplete |
| React Native Hermes bundle | Tool:Hermes-dec | AGPL-3.0 | HBC, version 84 in the README example | output is pseudo-code, not valid JavaScript |
| GameMaker data.win | Tool:UndertaleModTool | GPL-3.0 | Unverified | Windows GUI only |
| Flash SWF | Tool:JPEXS Free Flash Decompiler | GPL-3.0 | Unverified | none documented |
| Native code | Tool:Ghidra | Apache-2.0 | many processors and formats | read its security advisories |
| Native code | Tool:RetDec | MIT | x86, ARM, MIPS, PIC32, PowerPC, x86-64, ARM64 | limited maintenance |
| Native code | IDA Pro, Binary Ninja | commercial | Unverified | not read; no source documentation consulted |
Decision notes
- Python: pick by version. 3.8 or older: Uncompyle6 (3.7/3.8 also Decompyle3). 3.9 and later: PyLingual or Pycdc. Always read the disassembly (
pycdas) when output looks wrong. - The Python-based decompilers run only on specific host interpreters; the uncompyle6 README says its releases are split by interpreter range (3.0-3.2, 3.3-3.5, 3.6-3.10, 3.11 and later).
- Java: run two of CFR, Vineflower and JADX on the same class; they differ on lambdas, switch and try constructs. JADX is the default for Android because it reads dex and resources directly.
- Packed or obfuscated input is a different problem; identify the protector first.
Related
Format:PYC (Python compiled bytecode), Format:Lua bytecode, Format:LuaJIT bytecode, Format:Java class file, Format:DEX, Format:.NET metadata (ECMA-335), Format:Dart AOT snapshot, Format:Hermes bytecode (HBC).
Sources
The READMEs and licence files of the tools' repositories, read in October 2026. Licence cells marked Unverified were not found in the root file I fetched.