# skylot/jadx architecture

> Architecture diagram of the GitHub repository skylot/jadx, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/skylot/jadx
- Repository: https://github.com/skylot/jadx
- Video tour (about a minute): https://gitdiagram.com/skylot/jadx/video

## Overview

JADX decompiles Android and Java bytecode into Java source, with command-line and GUI front ends. The principal workflow accepts APK, DEX and archive inputs, loads bytecode and resources through input plugins, builds an internal representation, applies transformations such as deobfuscation, and emits source and decoded resources. The GUI also supports code navigation, search, renaming and smali debugging; plugin management and alternate inputs extend the product. Some internal links are dashed because the relevant implementation was not sampled; README statements establish the documented features, not every runtime call.

Main entry points: [`jadx-core/src/main/java/jadx/api/JadxDecompiler.java`](https://github.com/skylot/jadx/blob/master/jadx-core/src/main/java/jadx/api/JadxDecompiler.java) (Decompiler API), [`jadx-gui/src/main/java/jadx/gui/ui/MainWindow.java`](https://github.com/skylot/jadx/blob/master/jadx-gui/src/main/java/jadx/gui/ui/MainWindow.java) (GUI window), [`jadx-plugins`](https://github.com/skylot/jadx/tree/master/jadx-plugins) (Input plugins), [`jadx-cli/src/main/java/jadx/cli/JadxCLI.java`](https://github.com/skylot/jadx/blob/master/jadx-cli/src/main/java/jadx/cli/JadxCLI.java) (CLI commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User entry points"]
  node_cli["CLI commands<br/>[JadxCLI.java]"]
  node_gui_main["GUI window<br/>[MainWindow.java]"]
end

subgraph group_ingest["Input and resources"]
  node_input_plugins["Input plugins"]
  node_dex_parse["DEX parsing"]
  node_java_parse["Java parsing"]
  node_archive_input["Archive inputs"]
  node_zip_reader["ZIP reader<br/>[ZipReader.java]"]
  node_resource_decode["Resource decoding"]
end

subgraph group_engine["Decompilation engine"]
  node_api_args["Decompiler options<br/>[JadxArgs.java]"]
  node_decompiler["Decompiler API"]
  node_root_nodes["Bytecode model<br/>[RootNode.java]"]
  node_deobfuscation["Name deobfuscation"]
  node_codegen["Java code generation<br/>[CodeGen.java]"]
end

subgraph group_output["Output and plugins"]
  node_save_output["Save results"]
  node_plugin_manager["Plugin management"]
end

subgraph group_gui["GUI exploration"]
  node_gui_tree["Class navigation<br/>[JClass.java]"]
  node_gui_tabs["Code tabs<br/>[TabbedPane.java]"]
  node_gui_rename["Rename workflow<br/>[RenameService.java]"]
  node_gui_debugger["Smali debugger"]
  node_gui_search["Binary search"]
  node_gui_plugins["GUI plugins"]
end

node_cli_user(("CLI user"))
node_gui_user(("GUI user"))

node_cli_user -->|"runs"| node_cli
node_gui_user -->|"opens"| node_gui_main
node_cli -.->|"configures"| node_api_args
node_cli -.->|"starts"| node_decompiler
node_gui_main -.->|"loads project"| node_decompiler
node_decompiler -.->|"uses options"| node_api_args
node_decompiler -.->|"loads inputs"| node_input_plugins
node_input_plugins -.->|"parses DEX"| node_dex_parse
node_input_plugins -.->|"parses Java"| node_java_parse
node_input_plugins -.->|"handles archives"| node_archive_input
node_archive_input -.->|"reads archives"| node_zip_reader
node_decompiler -.->|"decodes resources"| node_resource_decode
node_decompiler -.->|"builds model"| node_root_nodes
node_root_nodes -.->|"renames nodes"| node_deobfuscation
node_decompiler -.->|"decompiles classes"| node_codegen
node_decompiler -->|"saves results"| node_save_output
node_decompiler -->|"registers plugins"| node_plugin_manager
node_gui_main -.->|"shows classes"| node_gui_tree
node_gui_tree -->|"requests decompile"| node_decompiler
node_gui_tree -.->|"opens code"| node_gui_tabs
node_gui_main -->|"handles renames"| node_gui_rename
node_gui_main -->|"offers debugging"| node_gui_debugger
node_gui_main -->|"offers search"| node_gui_search
node_gui_main -->|"loads GUI plugins"| node_gui_plugins

click node_cli "https://github.com/skylot/jadx/blob/master/jadx-cli/src/main/java/jadx/cli/JadxCLI.java"
click node_gui_main "https://github.com/skylot/jadx/blob/master/jadx-gui/src/main/java/jadx/gui/ui/MainWindow.java"
click node_api_args "https://github.com/skylot/jadx/blob/master/jadx-core/src/main/java/jadx/api/JadxArgs.java"
click node_decompiler "https://github.com/skylot/jadx/blob/master/jadx-core/src/main/java/jadx/api/JadxDecompiler.java"
click node_input_plugins "https://github.com/skylot/jadx/tree/master/jadx-plugins"
click node_dex_parse "https://github.com/skylot/jadx/tree/master/jadx-plugins/jadx-dex-input/src/main/java/jadx/plugins/input/dex"
click node_java_parse "https://github.com/skylot/jadx/tree/master/jadx-plugins/jadx-java-input/src/main/java/jadx/plugins/input/java"
click node_archive_input "https://github.com/skylot/jadx/tree/master/jadx-plugins/jadx-apks-input/src/main/kotlin/jadx/plugins/input/apks"
click node_zip_reader "https://github.com/skylot/jadx/blob/master/jadx-commons/jadx-zip/src/main/java/jadx/zip/ZipReader.java"
click node_resource_decode "https://github.com/skylot/jadx/tree/master/jadx-core/src/main/java/jadx/core/xmlgen"
click node_root_nodes "https://github.com/skylot/jadx/blob/master/jadx-core/src/main/java/jadx/core/dex/nodes/RootNode.java"
click node_deobfuscation "https://github.com/skylot/jadx/blob/master/jadx-core/src/main/java/jadx/core/deobf/DeobfuscatorVisitor.java"
click node_codegen "https://github.com/skylot/jadx/blob/master/jadx-core/src/main/java/jadx/core/codegen/CodeGen.java"
click node_save_output "https://github.com/skylot/jadx/blob/master/jadx-core/src/main/java/jadx/api/JadxDecompiler.java"
click node_plugin_manager "https://github.com/skylot/jadx/blob/master/jadx-core/src/main/java/jadx/core/plugins/JadxPluginManager.java"
click node_gui_tree "https://github.com/skylot/jadx/blob/master/jadx-gui/src/main/java/jadx/gui/treemodel/JClass.java"
click node_gui_tabs "https://github.com/skylot/jadx/blob/master/jadx-gui/src/main/java/jadx/gui/ui/tab/TabbedPane.java"
click node_gui_rename "https://github.com/skylot/jadx/blob/master/jadx-gui/src/main/java/jadx/gui/events/services/RenameService.java"
click node_gui_debugger "https://github.com/skylot/jadx/blob/master/jadx-gui/src/main/java/jadx/gui/device/debugger/DebugController.java"
click node_gui_search "https://github.com/skylot/jadx/blob/master/jadx-gui/src/main/java/jadx/gui/ui/hexviewer/search/service/BinarySearchService.java"
click node_gui_plugins "https://github.com/skylot/jadx/blob/master/jadx-gui/src/main/java/jadx/gui/plugins/GuiPluginsManager.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_gui_main,node_cli_user,node_gui_user toneBlue
class node_input_plugins,node_dex_parse,node_java_parse,node_archive_input,node_zip_reader,node_resource_decode toneAmber
class node_api_args,node_decompiler,node_root_nodes,node_deobfuscation,node_codegen toneMint
class node_save_output,node_plugin_manager toneRose
class node_gui_tree,node_gui_tabs,node_gui_rename,node_gui_debugger,node_gui_search,node_gui_plugins toneIndigo
```

## Components

### User entry points

- [CLI commands](https://github.com/skylot/jadx/blob/master/jadx-cli/src/main/java/jadx/cli/JadxCLI.java): `jadx-cli/src/main/java/jadx/cli/JadxCLI.java`
- [GUI window](https://github.com/skylot/jadx/blob/master/jadx-gui/src/main/java/jadx/gui/ui/MainWindow.java): `jadx-gui/src/main/java/jadx/gui/ui/MainWindow.java`

### Input and resources

- [Input plugins](https://github.com/skylot/jadx/tree/master/jadx-plugins): `jadx-plugins`
- [DEX parsing](https://github.com/skylot/jadx/tree/master/jadx-plugins/jadx-dex-input/src/main/java/jadx/plugins/input/dex): `jadx-plugins/jadx-dex-input/src/main/java/jadx/plugins/input/dex`
- [Java parsing](https://github.com/skylot/jadx/tree/master/jadx-plugins/jadx-java-input/src/main/java/jadx/plugins/input/java): `jadx-plugins/jadx-java-input/src/main/java/jadx/plugins/input/java`
- [Archive inputs](https://github.com/skylot/jadx/tree/master/jadx-plugins/jadx-apks-input/src/main/kotlin/jadx/plugins/input/apks): `jadx-plugins/jadx-apks-input/src/main/kotlin/jadx/plugins/input/apks`
- [ZIP reader](https://github.com/skylot/jadx/blob/master/jadx-commons/jadx-zip/src/main/java/jadx/zip/ZipReader.java): `jadx-commons/jadx-zip/src/main/java/jadx/zip/ZipReader.java`
- [Resource decoding](https://github.com/skylot/jadx/tree/master/jadx-core/src/main/java/jadx/core/xmlgen): `jadx-core/src/main/java/jadx/core/xmlgen`

### Decompilation engine

- [Decompiler options](https://github.com/skylot/jadx/blob/master/jadx-core/src/main/java/jadx/api/JadxArgs.java): `jadx-core/src/main/java/jadx/api/JadxArgs.java`
- [Decompiler API](https://github.com/skylot/jadx/blob/master/jadx-core/src/main/java/jadx/api/JadxDecompiler.java): `jadx-core/src/main/java/jadx/api/JadxDecompiler.java`
- [Bytecode model](https://github.com/skylot/jadx/blob/master/jadx-core/src/main/java/jadx/core/dex/nodes/RootNode.java): `jadx-core/src/main/java/jadx/core/dex/nodes/RootNode.java`
- [Name deobfuscation](https://github.com/skylot/jadx/blob/master/jadx-core/src/main/java/jadx/core/deobf/DeobfuscatorVisitor.java): `jadx-core/src/main/java/jadx/core/deobf/DeobfuscatorVisitor.java`
- [Java code generation](https://github.com/skylot/jadx/blob/master/jadx-core/src/main/java/jadx/core/codegen/CodeGen.java): `jadx-core/src/main/java/jadx/core/codegen/CodeGen.java`

### Output and plugins

- [Save results](https://github.com/skylot/jadx/blob/master/jadx-core/src/main/java/jadx/api/JadxDecompiler.java): `jadx-core/src/main/java/jadx/api/JadxDecompiler.java`
- [Plugin management](https://github.com/skylot/jadx/blob/master/jadx-core/src/main/java/jadx/core/plugins/JadxPluginManager.java): `jadx-core/src/main/java/jadx/core/plugins/JadxPluginManager.java`

### GUI exploration

- [Class navigation](https://github.com/skylot/jadx/blob/master/jadx-gui/src/main/java/jadx/gui/treemodel/JClass.java): `jadx-gui/src/main/java/jadx/gui/treemodel/JClass.java`
- [Code tabs](https://github.com/skylot/jadx/blob/master/jadx-gui/src/main/java/jadx/gui/ui/tab/TabbedPane.java): `jadx-gui/src/main/java/jadx/gui/ui/tab/TabbedPane.java`
- [Rename workflow](https://github.com/skylot/jadx/blob/master/jadx-gui/src/main/java/jadx/gui/events/services/RenameService.java): `jadx-gui/src/main/java/jadx/gui/events/services/RenameService.java`
- [Smali debugger](https://github.com/skylot/jadx/blob/master/jadx-gui/src/main/java/jadx/gui/device/debugger/DebugController.java): `jadx-gui/src/main/java/jadx/gui/device/debugger/DebugController.java`
- [Binary search](https://github.com/skylot/jadx/blob/master/jadx-gui/src/main/java/jadx/gui/ui/hexviewer/search/service/BinarySearchService.java): `jadx-gui/src/main/java/jadx/gui/ui/hexviewer/search/service/BinarySearchService.java`
- [GUI plugins](https://github.com/skylot/jadx/blob/master/jadx-gui/src/main/java/jadx/gui/plugins/GuiPluginsManager.java): `jadx-gui/src/main/java/jadx/gui/plugins/GuiPluginsManager.java`

### Other components

- **CLI user**
- **GUI user**

## Connections

- CLI user → CLI commands: runs (evidence: `README.md`)
- GUI user → GUI window: opens (evidence: `README.md`)
- CLI commands → Decompiler options: configures
- CLI commands → Decompiler API: starts
- GUI window → Decompiler API: loads project
- Decompiler API → Decompiler options: uses options (evidence: `jadx-core/src/main/java/jadx/api/JadxDecompiler.java`)
- Decompiler API → Input plugins: loads inputs (evidence: `jadx-core/src/main/java/jadx/api/JadxDecompiler.java`)
- Input plugins → DEX parsing: parses DEX
- Input plugins → Java parsing: parses Java (evidence: `jadx-plugins/jadx-java-input/src/main/java/jadx/plugins/input/java/data/attributes/JavaAttrStorage.java`)
- Input plugins → Archive inputs: handles archives
- Archive inputs → ZIP reader: reads archives
- Decompiler API → Resource decoding: decodes resources (evidence: `jadx-core/src/main/java/jadx/api/JadxDecompiler.java`)
- Decompiler API → Bytecode model: builds model (evidence: `jadx-core/src/main/java/jadx/api/JadxDecompiler.java`)
- Bytecode model → Name deobfuscation: renames nodes
- Decompiler API → Java code generation: decompiles classes
- Decompiler API → Save results: saves results (evidence: `jadx-core/src/main/java/jadx/api/JadxDecompiler.java`)
- Decompiler API → Plugin management: registers plugins (evidence: `jadx-core/src/main/java/jadx/api/JadxDecompiler.java`)
- GUI window → Class navigation: shows classes (evidence: `jadx-gui/src/main/java/jadx/gui/treemodel/JClass.java`)
- Class navigation → Decompiler API: requests decompile (evidence: `jadx-gui/src/main/java/jadx/gui/treemodel/JClass.java`)
- Class navigation → Code tabs: opens code (evidence: `jadx-gui/src/main/java/jadx/gui/treemodel/JClass.java`)
- GUI window → Rename workflow: handles renames (evidence: `jadx-gui/src/main/java/jadx/gui/events/services/RenameService.java`)
- GUI window → Smali debugger: offers debugging (evidence: `README.md`)
- GUI window → Binary search: offers search (evidence: `README.md`)
- GUI window → GUI plugins: loads GUI plugins (evidence: `jadx-gui/src/main/java/jadx/gui/plugins/GuiPluginsManager.java`)
