This is the GUI for angr. Launch it and analyze some binaries!
Some screenshots:
The easiest way to run angr-management is by grabbing a bundled release here: https://github.com/angr/angr-management/releases
This binary, built with pyinstaller, can be placed and executed anywhere.
To install angr-management, use pip:
pip install angr-management
The version on PyPI may not be up-to-date. Please consider having a development install if you plan to use latest features/fixes in angr Management.
See angr-dev for how to set up a development enviroment for the angr suite.
To run angr-management:
python -m angrmanagement
Or if you have a development install:
python start.py
-
Load a new binary:
Ctrl+O
-
Load a new Docker Image
Ctrl+Shift+O
-
Save angr database... :
Ctrl+S
-
Save angr database as... :
Ctrl+Shift+S
-
Decompile:
F5
-
Documentation:
Alt+H
-
Next Tab:
Ctrl+Tab
-
Previous Tab:
Ctrl+Shift+Tab
-
Split / Unsplit View:
Ctrl+D
Plugins may be installed by placing a subdirectory under plugins
. The directory must contain an __init__.py
like that in TestPlugin
:
from .test_plugin import TestPlugin
PLUGIN_CLS_NAME = TestPlugin.__name__
This also allows you to import a plugin class from another package entirely. The plugin itself should inherit from BasePlugin
. Callbacks and events are a work in progress, so the API is subject to change. See TestPlugin
for an example of a multithreaded plugin sample.
Your capstone install does not support functionality that angr-management uses.
To install a version that does (in your angr virtualenv):
workon angr
git clone https://github.com/angr/capstone
cd capstone
git checkout next
./make.sh
PACKAGES_PATH=$(python -c "from distutils.sysconfig import get_python_lib; print(get_python_lib())")
mkdir -p $PACKAGES_PATH/capstone
cp libcapstone.so.4 $PACKAGES_PATH/capstone/libcapstone.so
cd bindings/python
pip uninstall capstone # if already installed
python setup.py install