MCPcopy
hub / github.com/skylot/jadx

github.com/skylot/jadx @v1.5.5 sqlite

repository ↗ · DeepWiki ↗ · release v1.5.5 ↗
15,816 symbols 56,935 edges 1,792 files 700 documented · 4%
README

JADX

Build status GitHub contributors GitHub all releases GitHub release (latest by SemVer) Latest release Maven Central Java 11+ License

jadx - Dex to Java decompiler

Command line and GUI tools for producing Java source code from Android Dex and Apk files

[!WARNING] Please note that in most cases jadx can't decompile all 100% of the code, so errors will occur.

Check Troubleshooting guide for workarounds.

Main features: - decompile Dalvik bytecode to Java code from APK, dex, aar, aab and zip files - decode AndroidManifest.xml and other resources from resources.arsc - deobfuscator included

jadx-gui features: - view decompiled code with highlighted syntax - jump to declaration - find usage - full text search - smali debugger, check wiki page for setup and usage

Jadx-gui key bindings can be found here

See these features in action here: jadx-gui features overview

Download

After download unpack zip file go to bin directory and run: - jadx - command line version - jadx-gui - UI version

On Windows run .bat files with double-click\ Note: ensure you have installed Java 11 or later 64-bit version. For Windows, you can download it from oracle.com (select x64 Installer).

Install

  • Arch Linux Arch Linux package AUR Version bash sudo pacman -S jadx
  • macOS homebrew version bash brew install jadx
  • Flathub Flathub Version bash flatpak install flathub com.github.skylot.jadx

Use jadx as a library

You can use jadx in your java projects, check details on wiki page

Build from source

JDK 11 or higher must be installed:

git clone https://github.com/skylot/jadx.git
cd jadx
./gradlew dist

(on Windows, use gradlew.bat instead of ./gradlew)

Scripts for run jadx will be placed in build/jadx/bin and also packed to build/jadx-<version>.zip

Usage

``` jadx[-gui] [command] [options] (.apk, .dex, .jar, .class, .smali, .zip, .aar, .arsc, .aab, .xapk, .apkm, .jadx.kts) commands (use ' --help' for command options): plugins - manage jadx plugins

options: -d, --output-dir - output directory -ds, --output-dir-src - output directory for sources -dr, --output-dir-res - output directory for resources -r, --no-res - do not decode resources -s, --no-src - do not decompile source code -j, --threads-count - processing threads count, default: 16 --single-class - decompile a single class, full name, raw or alias --single-class-output - file or dir for write if decompile a single class --output-format - can be 'java' or 'json', default: java -e, --export-gradle - save as gradle project (set '--export-gradle-type' to 'auto') --export-gradle-type - Gradle project template for export: 'auto' - detect automatically 'android-app' - Android Application (apk) 'android-library' - Android Library (aar) 'simple-java' - simple Java -m, --decompilation-mode - code output mode: 'auto' - trying best options (default) 'restructure' - restore code structure (normal java code) 'simple' - simplified instructions (linear, with goto's) 'fallback' - raw instructions without modifications --show-bad-code - show inconsistent code (incorrectly decompiled) --no-xml-pretty-print - do not prettify XML --no-imports - disable use of imports, always write entire package name --no-debug-info - disable debug info parsing and processing --add-debug-lines - add comments with debug line numbers if available --no-inline-anonymous - disable anonymous classes inline --no-inline-methods - disable methods inline --no-move-inner-classes - disable move inner classes into parent --no-inline-kotlin-lambda - disable inline for Kotlin lambdas --no-finally - don't extract finally block --no-restore-switch-over-string - don't restore switch over string --no-replace-consts - don't replace constant value with matching constant field --escape-unicode - escape non latin characters in strings (with \u) --respect-bytecode-access-modifiers - don't change original access modifiers --mappings-path - deobfuscation mappings file or directory. Allowed formats: Tiny and Tiny v2 (both '.tiny'), Enigma (.mapping) or Enigma directory --mappings-mode - set mode for handling the deobfuscation mapping file: 'read' - just read, user can always save manually (default) 'read-and-autosave-every-change' - read and autosave after every change 'read-and-autosave-before-closing' - read and autosave before exiting the app or closing the project 'ignore' - don't read or save (can be used to skip loading mapping files referenced in the project file) --deobf - activate deobfuscation --deobf-min - min length of name, renamed if shorter, default: 3 --deobf-max - max length of name, renamed if longer, default: 64 --deobf-whitelist - space separated list of classes (full name) and packages (ends with '.') to exclude from deobfuscation, default: android.support.v4. android.support.v7. android.support.v4.os. android.support.annotation.Px androidx.core.os.* androidx.annotation.Px --deobf-cfg-file - deobfuscation mappings file used for JADX auto-generated names (in the JOBF file format), default: same dir and name as input file with '.jobf' extension --deobf-cfg-file-mode - set mode for handling the JADX auto-generated names' deobfuscation map file: 'read' - read if found, don't save (default) 'read-or-save' - read if found, save otherwise (don't overwrite) 'overwrite' - don't read, always save 'ignore' - don't read and don't save --deobf-res-name-source - better name source for resources: 'auto' - automatically select best name (default) 'resources' - use resources names 'code' - use R class fields names --use-source-name-as-class-name-alias - use source name as class name alias: 'always' - always use source name if it's available 'if-better' - use source name if it seems better than the current one 'never' - never use source name, even if it's available --source-name-repeat-limit - allow using source name if it appears less than a limit number, default: 10 --use-kotlin-methods-for-var-names - use kotlin intrinsic methods to rename variables, values: disable, apply, apply-and-hide, default: apply --use-headers-for-detect-resource-extensions - Use headers for detect resource extensions if resource obfuscated --rename-flags - fix options (comma-separated list of): 'case' - fix case sensitivity issues (according to --fs-case-sensitive option), 'valid' - rename java identifiers to make them valid, 'printable' - remove non-printable chars from identifiers, or single 'none' - to disable all renames or single 'all' - to enable all (default) --integer-format - how integers are displayed: 'auto' - automatically select (default) 'decimal' - use decimal 'hexadecimal' - use hexadecimal --type-update-limit - type update limit count (per one instruction), default: 10 --fs-case-sensitive - treat filesystem as case sensitive, false by default --cfg - save methods control flow graph to dot file --raw-cfg - save methods control flow graph (use raw instructions) -f, --fallback - set '--decompilation-mode' to 'fallback' (deprecated) --use-dx - use dx/d8 to convert java bytecode --comments-level - set code comments level, values: error, warn, info, debug, user-only, none, default: info --log-level - set log level, values: quiet, progress, error, warn, info, debug, default: progress -v, --verbose - verbose output (set --log-level to DEBUG) -q, --quiet - turn off output (set --log-level to QUIET) --disable-plugins - comma separated list of plugin ids to disable --config - load configuration from file, can be: path to '.json' file short name - uses file with this name from config directory 'none' - to disable config loading --save-config - save current options into configuration file and exit, can be: empty - for default config path to '.json' file short name - file will be saved in config directory --print-files - print files and directories used by jadx (config, cache, temp) --version - print jadx version -h, --help - print this help

Plugin options (-P=): dex-input: Load .dex and .apk files - dex-input.verify-checksum - verify dex file checksum before load, values: [yes, no], default: yes java-convert: Convert .class, .jar and .aar files to dex - java-convert.mode - convert mode, values: [dx, d8, both], default: both - java-convert.d8-desugar - use de

Extension points exported contracts — how you extend this code

ISeqConsumer (Interface)
"Sequence consumer" allows getting count of elements available [83 implementers]
jadx-plugins/jadx-input-api/src/main/java/jadx/api/plugins/input/data/ISeqConsumer.java
ITabStatesListener (Interface)
Tabbed pane events listener [6 implementers]
jadx-gui/src/main/java/jadx/gui/ui/tab/ITabStatesListener.java
IDexTreeVisitor (Interface)
Visitor interface for traverse dex tree [10 implementers]
jadx-core/src/main/java/jadx/core/dex/visitors/IDexTreeVisitor.java
IJavaAttribute (Interface)
(no doc) [16 implementers]
jadx-plugins/jadx-java-input/src/main/java/jadx/plugins/input/java/data/attributes/IJavaAttribute.java
IZipParser (Interface)
(no doc) [11 implementers]
jadx-commons/jadx-zip/src/main/java/jadx/zip/IZipParser.java
IJadxPluginResolver (Interface)
(no doc) [4 implementers]
jadx-plugins-tools/src/main/java/jadx/plugins/tools/resolvers/IJadxPluginResolver.java
IJadxConfig (Interface)
Marker interface for jadx config objects [1 implementers]
jadx-cli/src/main/java/jadx/cli/config/IJadxConfig.java
IDexData (Interface)
(no doc) [2 implementers]
jadx-plugins/jadx-dex-input/src/main/java/jadx/plugins/input/dex/utils/IDexData.java

Core symbols most depended-on inside this repo

add
called by 1244
jadx-core/src/main/java/jadx/core/dex/attributes/IAttributeNode.java
add
called by 1081
jadx-core/src/main/java/jadx/api/ICodeCache.java
get
called by 630
jadx-core/src/main/java/jadx/core/dex/attributes/IAttributeNode.java
isEmpty
called by 579
jadx-core/src/main/java/jadx/api/data/ICodeData.java
str
called by 561
jadx-gui/src/main/java/jadx/gui/utils/NLS.java
append
called by 466
jadx-core/src/main/java/jadx/core/dex/attributes/nodes/RenameReasonAttr.java
contains
called by 444
jadx-core/src/main/java/jadx/core/dex/attributes/IAttributeNode.java
get
called by 431
jadx-core/src/main/java/jadx/api/ICodeCache.java

Shape

Method 13,112
Class 2,412
Interface 178
Enum 114

Languages

Java100%

Modules by API surface

jadx-gui/src/main/java/jadx/gui/settings/JadxSettings.java191 symbols
jadx-core/src/main/java/jadx/api/JadxArgs.java155 symbols
jadx-gui/src/main/java/jadx/gui/device/debugger/SmaliDebugger.java140 symbols
jadx-cli/src/main/java/jadx/cli/JadxCLIArgs.java137 symbols
jadx-gui/src/main/java/jadx/gui/device/debugger/DebugController.java128 symbols
jadx-core/src/main/java/jadx/core/dex/instructions/args/ArgType.java125 symbols
jadx-gui/src/main/java/jadx/gui/ui/MainWindow.java113 symbols
jadx-core/src/main/java/jadx/core/dex/nodes/ClassNode.java103 symbols
jadx-gui/src/main/java/jadx/gui/settings/JadxSettingsData.java98 symbols
jadx-core/src/main/java/jadx/core/dex/nodes/MethodNode.java93 symbols
jadx-core/src/main/java/jadx/core/utils/BlockUtils.java89 symbols
jadx-core/src/test/java/jadx/tests/api/IntegrationTest.java66 symbols

For agents

$ claude mcp add jadx \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact