diff --git a/README.md b/README.md index 199f4f1..263f445 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,10 @@ Ghidrathon is a Ghidra extension that adds Python 3 scripting capabilities to Ghidra. Why? Ghidra natively supports scripting in Java and Jython. Unfortunately many open-source analysis tools, like [capa](https://github.com/mandiant/capa), [Unicorn Engine](https://github.com/unicorn-engine/unicorn), [angr](https://github.com/angr/angr), etc., are written in Python 3 making it difficult, and in some cases, impossible to use these tools in Ghidra. More so the security community has released several great plugins for other SRE frameworks like IDA Pro and Binary Ninja, but again, because many of these plugins use Python 3 it is difficult to port them to Ghidra. Ghidrathon helps you use existing and develop new Python 3 tooling in Ghidra and script Ghidra using modern Python in a way that tightly integrates with Ghidra's UI. +Check out: + +- The overview in our first [Ghidrathon blog post](https://www.mandiant.com/resources/blog/ghidrathon-snaking-ghidra-python-3-scripting) + Ghidrathon replaces the existing Python 2 extension implemented via Jython. This includes the interactive interpreter window, integration with the Ghidra Script Manager, and script execution in Ghidra headless mode. ## Python 3 Interpreter Window @@ -77,11 +81,13 @@ The following tools are needed to build, install, and run Ghidrathon: Tool | Version |Source | |---|---|---| -| Ghidra | `>= 10.1` | https://ghidra-sre.org | -| Jep | `>= 4.0` | https://github.com/ninia/jep | -| Gradle | `>= 6.8` | https://gradle.org/releases | +| Ghidra | `>= 10.2` | https://ghidra-sre.org | +| Jep | `>= 4.1` | https://github.com/ninia/jep | +| Gradle | `>= 7.3` | https://gradle.org/releases | | Python | `>= 3.7` | https://www.python.org/downloads | +Note: Ghidra >= 10.2 requires [JDK 17 64-bit](https://adoptium.net/temurin/releases/). + ## Python Virtual Environments Ghidrathon supports Python virtual environments. To use a Python virtual environment, simply build Ghidrathon inside your virtual environment **and** execute Ghidra inside the **same** virtual environment. diff --git a/data/ghidrathon_interp.png b/data/ghidrathon_interp.png index 42dab4c..15add98 100644 Binary files a/data/ghidrathon_interp.png and b/data/ghidrathon_interp.png differ