cutter/README.md

64 lines
3.5 KiB
Markdown
Raw Normal View History

2021-12-21 12:39:25 +00:00
<img width="150" height="150" align="left" style="float: left; margin: 0 10px 0 0;" alt="Cutter logo" src="https://raw.githubusercontent.com/rizinorg/cutter/dev/src/img/cutter.svg?sanitize=true">
2018-10-09 06:01:21 +00:00
2017-10-03 12:45:29 +00:00
# Cutter
2018-10-09 06:01:21 +00:00
2020-12-12 19:52:34 +00:00
Cutter is a free and open-source reverse engineering platform powered by [rizin](https://github.com/rizinorg/rizin). It aims at being an advanced and customizable reverse engineering platform while keeping the user experience in mind. Cutter is created by reverse engineers for reverse engineers.
2018-10-09 06:01:38 +00:00
2020-12-10 17:24:57 +00:00
[![Cutter CI](https://github.com/rizinorg/cutter/workflows/Cutter%20CI/badge.svg)](https://github.com/rizinorg/cutter/actions?query=workflow%3A%22Cutter+CI%22)
2021-12-21 12:39:25 +00:00
[![Build status](https://ci.appveyor.com/api/projects/status/tn7kttv55b8wf799/branch/dev?svg=true)](https://ci.appveyor.com/project/rizinorg/cutter/branch/dev)
2021-12-21 12:39:25 +00:00
![Screenshot](https://raw.githubusercontent.com/rizinorg/cutter/dev/docs/source/images/screenshot.png)
2020-12-12 19:52:34 +00:00
## Learn more at [cutter.re](https://cutter.re).
2020-12-12 19:52:34 +00:00
## Getting Cutter
### Download
2020-12-12 19:52:34 +00:00
Cutter release binaries for all major platforms (Linux, macOS, Windows) can be downloaded from [GitHub Releases](https://github.com/rizinorg/cutter/releases).
2017-10-14 18:25:23 +00:00
- **Linux**: If your distribution provides it, check for `cutter` package in your package manager (or `cutter-re`). If not available there, we have setup repositories in [OBS](https://openbuildservice.org/) for some common distributions. Look at [https://software.opensuse.org/package/cutter-re](https://software.opensuse.org/download/package?package=cutter-re&project=home%3ARizinOrg) and follow the instructions there. Otherwise download the `.AppImage` file from our release, make it executable and run as below or use [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher).
2018-09-30 10:53:31 +00:00
2020-12-12 19:52:34 +00:00
`chmod +x Cutter*.AppImage; ./Cutter*.AppImage`
- **macOS**: Download the `.dmg` file or use [Homebrew Cask](https://github.com/Homebrew/homebrew-cask):
2017-03-31 09:37:01 +00:00
`brew install --cask cutter`
- **Windows**: Download the `.zip` archive, or use either [Chocolatey](https://chocolatey.org) or [Scoop](https://scoop.sh/):
2020-12-12 19:52:34 +00:00
`choco install cutter`
`scoop bucket add extras` followed by `scoop install cutter`
2020-12-12 19:52:34 +00:00
### Build from sources
To build Cutter from sources, please check the [Building Docs](https://cutter.re/docs/building.html).
### Docker image
To deploy *cutter* using a pre-built `Dockerfile`, it's possible to use the [provided configuration](docker). The corresponding `README.md` file also contains instructions on how to get started using the docker image with minimal effort.
## Documentation
2020-12-12 19:52:34 +00:00
### [User Guide](https://cutter.re/docs/user-docs.html)
### [Contribution Guidelines](https://cutter.re/docs/contributing.html)
### [Developers Docs](https://cutter.re/docs/contributing/code.html)
## Plugins
2020-12-12 19:52:34 +00:00
Cutter supports both Python and Native C++ plugins.
Our community has built many plugins and useful scripts for Cutter such as the native integration of [Ghidra decompiler](https://github.com/rizinorg/rz-ghidra) or the plugin to visualize DynamoRIO code coverage. You can find a list of cutter plugins linked below. Feel free to extend it with your own plugins and scripts for Cutter.
**[Official & Community Plugins](https://github.com/rizinorg/cutter-plugins)**
2017-03-30 08:43:36 +00:00
2021-01-26 17:28:36 +00:00
**[Plugins Development Guide](https://cutter.re/docs/plugins.html)**
2017-03-30 08:43:36 +00:00
2020-12-12 19:52:34 +00:00
## Getting Help
2020-12-12 19:52:34 +00:00
Please use the following channels to ask for help from Cutter developers and community:
2020-12-10 17:24:57 +00:00
- **Telegram:** https://t.me/cutter_re
- **Mattermost:** https://im.rizin.re
- **IRC:** #cutter on https://web.libera.chat/
2020-12-10 17:24:57 +00:00
- **Twitter:** [@cutter_re](https://twitter.com/cutter_re)