Skip to content

Commit

Permalink
prepare 0.0.2
Browse files Browse the repository at this point in the history
  • Loading branch information
tintinweb committed May 14, 2020
1 parent 0668f9f commit 2cf72dd
Show file tree
Hide file tree
Showing 3 changed files with 21 additions and 4 deletions.
3 changes: 3 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,7 @@
# Change Log

## 0.0.2
- new: add experimental support for IDA Pro (Windows Only)

## 0.0.1
- Initial release
20 changes: 17 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 `<ghidra>/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:
Expand All @@ -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

Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down

0 comments on commit 2cf72dd

Please sign in to comment.