Skip to content

Godzil/reko

 
 

Repository files navigation

reko - a general purpose decompiler.

Build Status Join the chat at https://gitter.im/uxmal/reko

Reko (Swedish: "decent, obliging") is a C# project containing 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.

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 decompiler the binary (for instance if the binary is your own.)

Hacking

You should be able to build reko by simply cloning https://github.com/uxmal/reko and opening the reko-decompiler.sln solution file with Visual Studio 2012 or later, or MonoDevelop. All external dependencies are included in the external directory. The solution folder Drivers contains the executables that act as user interfaces: WindowsDecompiler is the GUI client for Windows; MonoDecompiler is the GUI client for Mono users; CmdLine is a command line driver. (Note: please let us know if you are not able to compile, so we can fix the issue for you.

You will receive warnings 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 only used when making MSI installer packages. You will not need to do this if you're already able to compile the project. If you do want to build an MSI installer with the WiX toolchain, you can download it here: http://wixtoolset.org/releases/

If you're interested in contributing code, see the road map for areas to explore. The Wiki has more information about the Reko project's internal workings.

Recent versions

See NEWS.md for the change log.

Packages

No packages published

Languages

  • Assembly 82.1%
  • Objective-C 9.1%
  • C# 7.3%
  • C 1.4%
  • C++ 0.1%
  • HTML 0.0%