GUI for angr

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for angr-bot from gravatar.com angr-bot Avatar for kphoenix from gravatar.com kphoenix Avatar for ltfish from gravatar.com ltfish Avatar for rhelmot from gravatar.com rhelmot Avatar for salls from gravatar.com salls Avatar for zardus from gravatar.com zardus

Unverified details

These details have not been verified by PyPI
Project links
GitHub Statistics

View statistics for this project via Libraries.io, or by using our public dataset on Google BigQuery

Meta

License: BSD License (BSD-2-Clause)

Requires: Python >=3.8

Classifiers

Project description

angr Management

Code style: black

This is the GUI for angr. Launch it and analyze some binaries!

Some screenshots:

Disassembly Decompilation

Installation

Portable, pre-built executable

The easiest way to run angr-management is by grabbing a bundled release from the releases page: https://github.com/angr/angr-management/releases

Builds can be extracted and then run from anywhere. Note that builds are currently unsigned.

From PyPI

To install angr-management, use pip:

pip install angr-management

angr-management can then be run with the command angr-management.

Development Install

See angr-dev for how to set up a development environment for the angr suite. angr-management is included by default and checked out to angr-management directory. If you encounter dependency issues, re-running setup.sh or setup.bat from angr-dev will ensure all dependencies are installed.

angr-management can then be run with angr-management or python start.py.

FLIRT signatures: For now, please manually clone FLIRT signatures by running git clone --recurse-submodules https://github.com/angr/angr-management, which will clone the flirt_signatures submodule.

Usage

Shortcuts

  • Load a new binary: Ctrl+O

  • Load a new Docker Image Ctrl+Shift+O

  • Load a Trace File Ctrl+Shift+T

  • 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

Configuration

Configuration files locations vary by platform.

  • Windows: ~\AppData\Local\angr-management\config.toml
  • macOS: ~/Library/Preferences/angr-management/config.toml
  • Linux: ~/.config/angr-management/config.toml

Plugins

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.

Scripting

Take a look at https://docs.angr.io/extending-angr/angr_management!

Building with PyInstaller

To build a portable executable using PyInstaller, install angr management into a python envrionment with the pyinstaller extra. Do not install anything in editable mode (pip's -e), as PyInstaller currently fails to bundle modules installed with editable mode. Then, run pyinstaller angr-management.spec.

If things go wrong, the best bet is to reference the nightly build pipeline and the PyInstaller docs. The CI environment that produces nightly builds is at .github/workflows/nightly-build.yml and .github/workflows/nightly-build.sh.

Project details

Verified details

These details have been verified by PyPI
Maintainers
Avatar for angr-bot from gravatar.com angr-bot Avatar for kphoenix from gravatar.com kphoenix Avatar for ltfish from gravatar.com ltfish Avatar for rhelmot from gravatar.com rhelmot Avatar for salls from gravatar.com salls Avatar for zardus from gravatar.com zardus

Unverified details

These details have not been verified by PyPI
Project links
GitHub Statistics

View statistics for this project via Libraries.io, or by using our public dataset on Google BigQuery

Meta

License: BSD License (BSD-2-Clause)

Requires: Python >=3.8

Classifiers

Release history Release notifications | RSS feed

This version

9.2.98

9.2.97

9.2.96

9.2.95

9.2.94

9.2.93

9.2.92

9.2.91

9.2.90

9.2.89

9.2.88

9.2.87

9.2.86

9.2.85

9.2.84

9.2.83

9.2.82

9.2.81

9.2.80

9.2.79

9.2.78

9.2.77

9.2.76

9.2.75

9.2.74

9.2.73

9.2.72

9.2.71

9.2.70

9.2.69

9.2.68

9.2.67

9.2.66

9.2.65

9.2.64

9.2.63

9.2.62

9.2.61

9.2.60

9.2.59

9.2.58

9.2.57

9.2.56

9.2.55

9.2.54

9.2.53

9.2.52

9.2.51

9.2.50

9.2.49

9.2.48

9.2.47

9.2.46

9.2.45

9.2.44

9.2.43

9.2.42

9.2.41

9.2.40

9.2.39

9.2.38

9.2.37

9.2.36

9.2.35

9.2.34

9.2.33

9.2.32

9.2.31

9.2.30

9.2.29

9.2.28

9.2.27

9.2.26

9.2.25

9.2.24

9.2.23

9.2.22

9.2.21

9.2.20

9.2.19

9.2.18

9.2.17

9.2.16

9.2.15

9.2.14

9.2.13

9.2.12

9.2.11

9.2.10

9.2.9

9.2.8

9.2.7

9.2.6

9.2.5

9.2.4

9.2.3

9.2.2

9.2.1

9.1.12332

9.1.11752

9.1.11611

9.1.11508

9.1.10913

9.0.10730

9.0.10689

9.0.10651

9.0.10576

9.0.10534

9.0.10409

9.0.10339

9.0.10281

9.0.10159

9.0.10072

9.0.10055

9.0.10010

9.0.9947

9.0.9792

9.0.9684

9.0.9572

9.0.9506

9.0.9438

9.0.9355

9.0.9297

9.0.9166

9.0.9031

9.0.8761

9.0.8021

9.0.7912

9.0.7833

9.0.7491

9.0.7293

9.0.6885

9.0.6852

9.0.6790

9.0.6642

9.0.6588

9.0.6488

9.0.6421

9.0.6281

9.0.6136

9.0.5903

9.0.5811

9.0.5739

9.0.5610

9.0.5609

9.0.5450

9.0.5405

9.0.5376

9.0.5327

9.0.5326

9.0.5171

9.0.5034

9.0.5002

9.0.4940

9.0.4885

9.0.4663

9.0.4495

9.0.4446

9.0.4378

8.20.7.27

8.20.7.6

8.20.6.8

8.20.6.1

8.20.5.27

8.20.1.7

8.19.10.30

8.19.10.29

8.19.7.25

8.19.4.5

8.19.2.4

8.18.10.25

8.18.10.5

7.8.9.26

7.8.8.1

7.8.7.1

7.8.6.23

7.8.6.16

7.8.2.21

7.7.12.16

7.7.9.8

6.7.7.27

6.7.6.9

6.7.4.12

6.7.3.26

6.7.3.13

6.7.1.31

6.7.1.13

5.6.12.3

5.6.10.7

5.6.10.5

4.6.6.28

4.6.6.15

4.6.3.15

4.5.12.21

4.5.11.23

4.5.9.22

4.5.9.14

4.5.9.13

4.5.9.9

4.5.9.9b pre-release

0.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

angr-management-9.2.98.tar.gz (1.3 MB view hashes)

Uploaded Source

Built Distribution

angr_management-9.2.98-py3-none-any.whl (1.4 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page