Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/uxmal/reko

Reko is a binary decompiler.
https://github.com/uxmal/reko

aarch64 arm decompile decompiler decompiler-engine disassemble disassembler dotnet m68k reverse-engineering risc-v x86 x86-64

Last synced: about 1 month ago
JSON representation

Reko is a binary decompiler.

Lists

README 

        

# reko - a general purpose decompiler.



[![Cirrus CI Build Status](https://api.cirrus-ci.com/github/uxmal/reko.svg?branch=master)](https://cirrus-ci.com/github/uxmal/reko)

[![GitHub workflow status](https://github.com/uxmal/reko/workflows/Reko/badge.svg)](https://github.com/uxmal/reko/actions/workflows/reko.yml)

[![Join us on Discord](https://img.shields.io/static/v1?link=https://discord.gg/9PMWVxEjqr&message=Join%20Discord&logo=discord&style=flat&color=107090&labelColor=5E5E5E&label=&logoColor=white)](https://discord.gg/9PMWVxEjqr)

[![Join the chat at https://gitter.im/uxmal/reko](https://badges.gitter.im/uxmal/reko.svg)](https://gitter.im/uxmal/reko?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)



 

 



**Reko** (Swedish: "decent, obliging") is a decompiler for machine code binaries.

This project is freely available under the GNU General Public License.



The project consists of front ends, core decompiler engine, and back

ends to help it achieve its goals.  A command-line, a Windows GUI,

and a ASP.NET front end exist at the time of writing.  The decompiler

engine receives inputs from the front ends in the form of either

individual executable files or decompiler project files. Reko

project files contain additional information about a binary file,

helpful to the decompilation process or for formatting the output.

The decompiler engine then proceeds to analyze the input binary.



    

        

            


            Byte map view of a loaded ARM binary executable

        

        

            


            Decompiled view of a loaded ARM binary executable

        

    



Reko has the ambition of supporting decompilation of various 

processor architectures and executable file formats with minimal user

intervention. For a complete list, see the

[supported binaries](https://github.com/uxmal/reko/wiki/Supported-binaries) 

page.



Please note that many software licenses prohibit decompilation or

other reverse engineering of their machine code binaries. Use this

decompiler only if you have legal rights to decompile the binary

(for instance if the binary is your own.)



## Downloading Reko



Official releases are published every few months on [Github](https://github.com/uxmal/reko/releases)

and [SourceForge](https://sourceforge.net/projects/decompiler/files/). 

Users who can't or won't build Reko themselves can download the output

of the [Cirrus CI integration builder](https://cirrus-ci.com/github/uxmal/reko) or the [Github Actions integration builder](https://github.com/uxmal/reko/actions/workflows/reko.yml).

Naturally you can build the project from the sources: see "Hacking" 

below.



## Installing Reko



The following prerequisite software must be installed on your machine first:

* .NET 6.0 (https://www.microsoft.com/net/download/dotnet-framework-runtime)



Download an appropriate installer and run it on the target machine.



After installation, you can proceed by either downloading binaries directly

from the integration build server, or by building Reko from sources (see `Hacking` 

below).



## Documentation



To get acquainted with Reko's various features, you can read the 

[user's guide](doc/guide/reko.md). If you're interested in the internal workings

of the project, see the wiki.



## Getting support



You can report any issues you encounter or ask any Reko-related question

on the [issue tracker](https://github.com/uxmal/reko/issues).

You can also try the Reko [Gitter.im](https://gitter.im/uxmal/reko)

chatroom. Reko is built by volunteers' efforts on their

spare time, so adjust your response-time expectations accordingly.



## Hacking



To build reko, start by cloning https://github.com/uxmal/reko. You

can use an IDE or the command line to build the solution file

`Reko-decompiler.sln`. Reko requires the [.NET 6.0 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/6.0)

to compile. If you are an IDE user, use a recent version of Visual Studio 2022.

If you wish to build using the command line, use the command



```cmd

dotnet msbuild -p:Platform={platform} -p:Configuration={config} -v:m -t:build_solution -m ./src/BuildTargets/BuildTargets.csproj

```

Replace `{config}` with either `Debug` or `Release`, and `{platform}` with `x64` or `x86`.



**Note**: please let us know if you still are not able to compile,

so we can help you fix the issue.



If you're interested in contributing code, see the

[road map](https://github.com/uxmal/reko/wiki/Roadmap) for areas to explore.

The [Wiki](https://github.com/uxmal/reko/wiki) has more information

about the Reko project's internal workings. Please consult the

 [style guide](https://github.com/uxmal/reko/blob/master/doc/style.md).



### Warnings and errors related to WiX



You will receive warnings or errors when loading the solution in Visual Studio

if you haven't installed the WiX toolset on your

development machine. You can safely ignore the warnings; the WiX

toolset is only used when making MSI installer packages. You will not need

to build an installer if you're already able to compile the project: the build

process copies all the necessary files into a single directory. 

If you do want to build an MSI installer with the WiX toolchain, you can

 download it here:

http://wixtoolset.org/releases/



### Errors related to CMake in Visual Studio



Depending on what you do Visual Studio might try to rebuild NativeProxy which

depends on CMake. You can either install [CMake](https://cmake.org/download/)

and make sure it's added to your PATH or disable the project in Visual Studio.



Having CMake installed as part of Visual Studio is sufficient to run msbuild

from the `Developer Command Prompt` but not when building from inside VS,

unless you've added that to your global PATH. Installing CMake externally allows

you to add it to PATH during the installation.



**NOTE**: there is an issue in certain versions of Visual Studio that can manifest itself

when loading the project. You'll notice it if Visual Studio is stuck "Running Background Tasks" 

and won't let you build the project. A workaround is to right click the "NativeProxy" project in the

solution explorer and choose "Unload Project". The project will then be able to load and build correctly.

This issue doesn't occur when building from the command line.



### How do I start Reko?



The solution folder `Drivers` contains the executables that act

as user interfaces. The subdirectory `WindowsDecompiler` contains

the GUI client for the Windows Forms user interface. The subdirectory

`AvaloniaShell` contains the GUI client for the cross-platform [Avalonia](https://avaloniaui.net/)

user interface (still under construction). `CmdLine` is a command line driver.



## Recent versions



See the [release log](https://github.com/uxmal/reko/releases) for the latest releases.