diff --git a/CHANGELOG.md b/CHANGELOG.md index 8ca1202..9433e9c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,4 +1,7 @@ # Change Log +## 0.0.2 +- new: add experimental support for IDA Pro (Windows Only) + ## 0.0.1 - Initial release diff --git a/README.md b/README.md index 7c07dcf..1a9542a 100644 --- a/README.md +++ b/README.md @@ -28,13 +28,27 @@ Have phun 🙌 ## Setup * Requires Java (11+) to be installed system-wide. Just install the latest JRE/JDK for your OS (e.g. openJDK). -* Requires a working installation of [Ghidra](https://ghidra-sre.org/) (← Download) +* Requires a working installation of [Ghidra](https://ghidra-sre.org/) (← Download) to decompile executables * either available in `PATH` (like when you installe it with with `brew cask install ghidra` on os-x; or set-up manually) * otherwise please specify the path to the executable `/support/analyzeHeadless` in `code → preferences → settings: vscode-decompiler.tool.ghidra.path` and make sure that the `analyzeHeadless` script runs without errors (and is not prompting for the JDK Home 🤓). Here's a sample Ghidra config for Windows: ![ghidraconf](https://user-images.githubusercontent.com/2865694/81807509-7dc76b00-951e-11ea-99d7-359bd624cce5.png) - +* (Experimental; Windows Only) Optional a licensed version of [IDA Pro](https://www.hex-rays.com/products/decompiler/) with decompiler support. + * specify the path to the `idaw` executable in `code → preferences → settings: vscode-decompiler.tool.idaPro.path`, e.g. `c:\IDA68\idaw.exe`. + * set preference for `idaPro (experimental Windows Only)` in `code → preferences → settings: vscode-decompiler.default.decompiler.selected`. + * we'll automatically try to run 32 and 64bits `idaw` on the target application (preference on what executable is configured by you) * Other tools are bundled with the extension. Just make sure Java is available in your `PATH`. +### Setting tool preferences + +`code → preferences → settings:` + +* Set default decompiler preference to `ghidra` (default) or `idaPro (experimental Windows Only)` (requires a licensed version of IDAPro + Decompiler) + * `vscode-decompiler.default.decompiler.selected` +* Set preference for java decompilation to JADX or JD-CLI (default) + * `vscode-decompiler.java.decompiler.selected` +* Set preference for android apk decompilation to dex2jar + jd-cli (slow) or JADx (default) + * `vscode-decompiler.apk.decompiler.selected"` + ## Credits This extension wouldn't be possible without the smarties that are developing the following reverse-engineering tools: @@ -43,8 +57,8 @@ This extension wouldn't be possible without the smarties that are developing the * [JadX](https://github.com/skylot/jadx/) * [JD-CLI](https://github.com/kwart/jd-cmd) * [dex2Jar](https://github.com/pxb1988/dex2jar) +* [IDA Pro Advanced & Decompiler](https://www.hex-rays.com/products/decompiler/) * LogoMakr (CC; Logo) -* [pwndra](https://github.com/0xb0bb/pwndra) Ghidra Scripts ## Release Notes diff --git a/package.json b/package.json index 571bde9..af4d7f0 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "vscode-decompiler", "displayName": "Decompiler", "description": "Decompile the $h*! out of things", - "version": "0.0.1", + "version": "0.0.2", "keywords": [ "security", "decompile",