Recaf

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

Download

• Managed launcher
  • Use the following launcher commands, one after another, to keep Recaf up-to-date and run it:
    • update-ci -b dev4
    • update-jfx
    • compatibility
    • run
  • Or run the launcher with the following argument to do that all for you in one go:
    • auto
  • To update Recaf use update-ci -b dev4. The -b <VALUE> can be used to specify other 4X based branches.
  • To run Recaf use the run command.
  • To use the run command you must use the update-jfx command at least once.
  • To validate your local environment can run Recaf the compatibility command tells you what conflicts exist, if any.
• Independent 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.

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 on scripting and plugin development.

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 -b dev4

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/recaf-ui-{VERSION}-all.jar