ch0ic3/cutter
1
0
Fork 0
mirror of https://github.com/rizinorg/cutter.git synced 2024-12-18 19:06:10 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
Free and Open Source Reverse Engineering Platform powered by rizin
994 Commits 13 Branches 64 Tags 31 MiB
C++ 93.4%
CMake 2.6%
CSS 1.4%
Python 0.9%
Shell 0.8%
Other 0.7%
9f7b96281d
Go to file
fcasal 9f7b96281d Debugging shortcuts (#578) 
* Added debug shortcuts and debug menu
* Added "Add breakpoint" shortcut
* Added debug shortcuts to readme
* Fix double memorymap ui
* Add bp F2 shortcut and fix toggling bp with shortcuts
2018-07-26 12:57:05 +02:00
.github Version 1.6 2018-07-13 20:37:18 +02:00
docker Docker: Fix typo in README.md, travis: fix image name (#564) 2018-07-06 08:48:15 +02:00
docs Add files via upload (#554) 2018-06-27 19:27:55 +02:00
radare2@b50080b363 Update radare2 and fix prepare_r2.bat (#590) 2018-07-23 20:36:14 +02:00
scripts Meson: move some code from meson.py to src/meson.build (#588) 2018-07-22 14:10:52 +02:00
src Debugging shortcuts (#578) 2018-07-26 12:57:05 +02:00
.appveyor.yml Version 1.6 2018-07-13 20:37:18 +02:00
.gitignore Debugging shortcuts (#578) 2018-07-26 12:57:05 +02:00
.gitmodules Remove cutter win32 (#58) 2017-10-15 21:19:48 +02:00
.travis.yml Switch back to official linuxdeployqt builds 2018-07-15 14:17:17 +02:00
build.bat Windows dist: move r2 related data to <radare2> subdir (#466) 2018-04-30 22:03:31 +02:00
build.sh Bashim 2018-05-25 14:12:20 +02:00
CONTRIBUTING.md Added info about nullptr and connect() style 2018-05-04 10:11:10 +02:00
COPYING LICENSE -> COPYING 2017-11-27 17:31:48 +01:00
meson.py Meson: move some code from meson.py to src/meson.build (#588) 2018-07-22 14:10:52 +02:00
prepare_r2.bat Update radare2 and fix prepare_r2.bat (#590) 2018-07-23 20:36:14 +02:00
README.md Debugging shortcuts (#578) 2018-07-26 12:57:05 +02:00

README.md

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

Cutter is available for all platforms (Linux, OS X, Windows). You can download the latest release here.

  • Linux: use the AppImage file. Then just make it executable and run it:
    • chmod +x Cutter-v1.6-x86_64.AppImage
    • ./Cutter-v1.6-x86_64.AppImage

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 --recurse-submodules https://github.com/radareorg/cutter
cd cutter

Building on linux:

./build.sh
Important note:

When using the default build.sh script you might encounter a ModuleNotFoundError upon starting Cutter. This can be resolved by either

  1. disabling the optional jupyter support during building by modifying build.sh as follows:

    • Uncomment #QMAKE_CONF="CUTTER_ENABLE_JUPYTER=false CUTTER_ENABLE_QTWEBENGINE=false"
    • Comment out the prior empty QMAKE_CONF=""

  2. or alternatively by installing the two python dependencies manually afterwards via:

pip3 install notebook jupyter_client

Building on Windows:

prepare_r2.bat
build.bat

If any of those do not work, check the more detailed version here.

Check this page for common issues.

Docker

To deploy cutter using a pre-built Dockerfile, it's possible to use the provided configuration. The corresponding README.md file also contains instructions on how to get started using the docker image with minimal effort.

Global shortcuts

Shortcut Function
. Focus console input
G/S Focus search bar
Ctrl/Cmd+R Refresh contents

Disassembly view shortcuts

Shortcut Function
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

Graph view shortcuts

Shortcut Function
Esc Seek to previous position
Space Switch to disassembly view
Ctrl/Cmd+MouseWheel Zoom
+ Zoom in
- Zoom out
= Reset zoom
J Next instruction
K Previous instruction

Debug shortcuts

Shortcut Function
F9 Start debug
F7 Step into
F8 Step over
F5 Continue
F2/(Ctrl/Cmd)+B Add breakpoint

Help

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