https://github.com/Col-E/Recaf

The modern Java bytecode editor
https://github.com/Col-E/Recaf

agent asm bytecode bytecode-engineering bytecode-manipulation decompile decompiler java java-decompiler javafx javafx-application jvm-bytecode reverse-engineering static-analysis

Last synced: about 2 months ago
JSON representation

The modern Java bytecode editor

• Host: GitHub
• URL: https://github.com/Col-E/Recaf
• Owner: Col-E
• License: mit
• Created: 2017-07-27T06:01:10.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2024-04-11T22:58:22.000Z (8 months ago)
• Last Synced: 2024-04-12T04:28:26.972Z (8 months ago)
• Topics: agent, asm, bytecode, bytecode-engineering, bytecode-manipulation, decompile, decompiler, java, java-decompiler, javafx, javafx-application, jvm-bytecode, reverse-engineering, static-analysis
• Language: Java
• Homepage: https://coley.software/Recaf/
• Size: 53 MB
• Stars: 5,524
• Watchers: 167
• Forks: 433
• Open Issues: 137
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• awesome - Col-E/Recaf - The modern Java bytecode editor (Java)
• Awesome-Pentest - Recaf - The modern Java bytecode editor. (Reverse Engineering Tools / Metadata Tools)
• awesome-hacking-lists - Col-E/Recaf - The modern Java bytecode editor (Java)
• StarryDivineSky - Col-E/Recaf

README

        
# Recaf [![Discord](https://dcbadge.limes.pink/api/server/https://discord.gg/Bya5HaA?style=flat)](https://discord.gg/Bya5HaA) [![codecov](https://codecov.io/gh/Col-E/Recaf/graph/badge.svg?token=N8GslpI1lL)](https://codecov.io/gh/Col-E/Recaf)  ![downloads](https://img.shields.io/github/downloads/Col-E/Recaf/total.svg) [![Contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](CONTRIBUTING.md)

![Recaf 4x UI](recaf.png)

An easy to use modern Java bytecode editor that abstracts away the complexities of Java programs.

## Download

- [Launcher](https://github.com/Col-E/Recaf-Launcher)

  - Usage & instructions found on the launcher repo

- [Snapshot releases](https://github.com/Col-E/Recaf-Launcher/blob/master/MANUAL.md)

  - See [CI actions](https://github.com/Col-E/Recaf/actions/workflows/build.yml) for release artifacts

- [Independent releases](https://github.com/Col-E/Recaf/releases) _(None for 4X currently)_

## Features

- Edit Java bytecode with ease from a high or low level _(minus the annoying parts)_

    - Editor features within Recaf abstract away complex details of compiled Java applications like:

        - The constant pool

        - Stack frame calculation

        - Using wide instructions when needed

        - And more!

- Easy to use navigable interface with context-sensitive actions

- Support for standard Java _and_ Android applications

- Multiple decompilers to switch between, with all of their parameters made fully configurable

- Built in compiler to allow recompiling decompiled classes, even if some referenced classes are missing *(When supported, support may vary depending on code complexity and obfuscation)*

- A bytecode assembler with a simple syntax, and supporting tooling

    - See the state of local variables and stack values at any point in methods

    - Access variables by names instead of indices for clearer disassembled code

    - Convert snippets of Java source code to bytecode sequences automatically

- Searching for a variety of different content: Strings/numeric constants, classes and member references, instruction patterns

- Tools for deobfuscating obfuscated code

    - Specially crafted class files with the intent of crashing reverse engineering tools are automatically patched when opened in Recaf

    - Specially crafted jar/zip files are read as the JVM does, bypassing sneaky tricks that can trick reverse engineering tools into showing the wrong data

    - Support for automatically renaming obfuscated classes and their members

    - Support for manually renaming classes and their members *_(And exporting these mappings to a variety of mapping formats for use in other tools)_*

- Attach to running Java process with instrumentation capabilities

- And much more

A complete list of features can be found in the [user documentation](https://recaf.coley.software/user/index.html).

## Scripting & Plugins

Recaf exposes almost all of its functionality through modular API's. Automating behaviors can be done easily with scripts, or with plugins for more complex situations. Additional features can also be added via plugins, which can register hooks in API's that offer them.

To create your own script or plugin, see the [developer documentation](https://recaf.coley.software/dev/index.html), specifically the _"plugins & scripts"_ section.

## Command Line

Recaf can run as a command line application, which can be especially useful when paired with scripts provided at startup. You can see all the current launch arguments by passing `--help` as an application argument.

## Development Setup

Clone the repository via `git clone https://github.com/Col-E/Recaf.git`

Open the project in an IDE or generate the build with gradle.

**IDE**:

1. Import the project from the `build.gradle` file

2. Create a run configuration with the main class `software.coley.recaf.Main`

**Without IDE**:

1. Run `gradlew build`

    - Output will be located at: `recaf-ui/build/libs/recaf-ui-{VERSION}-all.jar`