cutter/README.md
2018-02-25 09:53:29 +01:00

3.3 KiB

Cutter

Build Status Build status

A Qt and C++ GUI for radare2 reverse engineering framework (originally named Iaito).

Screenshot

Screenshot

Disclaimer

Cutter is not aimed at existing radare2 users. It instead focuses on those whose are not yet radare2 users because of the learning curve, because they don't like CLI applications or because of the difficulty/instability of radare2.

Installing

Downloading a release

You can download the latest release here.

Building from source

Requirements

Cutter is based on Qt so you will need to have it installed.

Building

First you must clone the repository:

git clone https://github.com/radareorg/cutter
cd cutter
Building radare2

/!\ WARNING /!\ This will delete your current radare2 version if any already installed.

git submodule init radare2 && git submodule update radare2
cd radare2 && ./sys/install.sh
cd ..
Building cutter

Cutter can be build with two methods: The preferred one is with qmake, but you can also compile it with cmake. Choose the one you want to use.

  • Method 1: Qmake
mkdir build
cd build
qmake ../src
make
  • Method 2: CMake
mkdir build
cd build
cmake ../src
make

Then run cutter: ./Cutter or ./build/Cutter

Note: If radare2 is not installed system-wide (./sys/user.sh installation for instance) you might want to use LD_LIBRARY_PATH=$HOME/bin/prefix/radare2/lib ./Cutter to run cutter.

Troubleshooting

On Mac, QT5 apps fail to build on QtCreator if you have the libjpeg lib installed with brew. Run this command to workaround the issue:

sudo mv /usr/local/lib/libjpeg.dylib /usr/local/lib/libjpeg.dylib.not-found

If you encounter the Project ERROR: r_core development package not found try this command instead PKG_CONFIG_PATH=$HOME/bin/prefix/radare2/lib/pkgconfig qmake

Platforms

Cutter is developed on OS X, Linux and Windows. The first release for users will include installers for all three platforms.

Keyboard shortcuts

Shortcut Function
Global shortcuts:
. Focus console input
G & S Focus search bar
F5 Refresh contents
Disassembly view:
Esc Seek to previous position
Space Switch to disassembly graph view
Ctrl/Cmd+C Copy
; Add comment
N Rename current function/flag
Shift+N Rename flag/function used here
X Show Xrefs
Disassembly graph view:
Esc Seek to previous position
Space Switch to disassembly view
+ Zoom in
- Zoom out
= Reset zoom
J Next instruction
K Previous instruction

Help

Right now the best place to obtain help from cutter developers and community is joining this telegram group: