james91b / ida_ipython

An IDA Pro Plugin for embedding an IPython Kernel
MIT License
252 stars 46 forks source link

What's New

What and Why?

This is a plugin to embed an IPython kernel in IDA Pro. The Python ecosystem has amazing libraries (and communities) for scientific computing. IPython itself is great for exploratory data analysis. Using tools such as the IPython notebook make it easy to share code and explanations with rich media. IPython makes using IDAPython and interacting with IDA programmatically really fun and easy.

Example Uses

QT Console

You can just use IPython qtconsole for a better interactive python shell for IDA.

Image of Basic QT Usage

You can also use the QT console to graph things. This is an example creating a bar chart for the occurrences of each instruction mnemonic in a function (in notepad.exe).

Image of QT with graph

Notebooks

Another useful case is using IPython notebooks.

More examples..soon...

How the plugin works

IDA is predominantly single threaded application, so we cannot safely run the kernel in a separate thread. So instead of using another thread a hook is created on the QT process events function and the do_one_iteration method of the ipython kernel is executed each frame.

Installation

I suggest using the Anaconda distribution of Python as it comes with all the required python libraries pre-built and installed. To get IDA to use Anaconda, simply set the PYTHONHOME enviroment variable. Alternatively you can install IPython and the dependencies separately.

This plugin should work on all 6.X x86 QT versions of IDA on Windows.

Basic Installation and QTConsole

  1. Download and extract the release
  2. Copy the contents of the plugins and python directories under IDA's installation directory.
  3. Launch IDA.
  4. At the command line (Windows), start an IPython qtconsole with the kernel instance (outputted in the IDA console) e.g ipython qtconsole --existing kernel-4264.json

Using the Notebook

  1. Copy idc directory to your IDA directory. (the nothing.idc script is used to pass command line parameters to the plugin)
  2. Change the paths to the idaq.exe and idaq64.exe executables in the kernel.json under the notebook\kernels\ida32 and notebook\kernels\ida64 directories respectively
  3. Install the kernels using jupyter-kernelspec install (e.g. jupyter-kernelspec install --user notebook\kernels\ida64)
  4. When starting a notebook, choose the IDA32 or IDA64 kernels, depending on your desired IDA version.

How to Build

  1. Install cmake
  2. At the command line cd to the root directory and run the following
  3. mkdir build
  4. cd build
  5. cmake -G "Visual Studio 11" -DPYTHON_DIR="<YOUR_PYTHON_DIR>" -DIDA_SDK="<YOUR_IDASDK_LOCATION>" -DIDA_DIR="<YOUR_IDA_DIRECTORY>" .. e.g. cmake -G "Visual Studio 11" -DPYTHON_DIR="C:\Anaconda" -DIDA_SDK="C:\dev\IDA\idasdks\idasdk64" -DIDA_DIR="C:/Program Files (x86)/IDA 6.4" ..
  6. cmake --build . --config Release

So far only tested with "Visual Studio 11" compiler.

Changelog

0.5

0.4

0.3

0.2

0.1

To do/Future Ideas