README.md

ILSpy

ILSpy is the open-source .NET assembly browser and decompiler.

Download: latest release | latest CI build (master)

CI Build Nuget Feed (master): https://ci.appveyor.com/nuget/ilspy-masterfeed

Decompiler Frontends

Aside from the WPF UI ILSpy (downloadable via Releases, see also plugins), the following other frontends are available:

• Visual Studio 2017 extension marketplace
• Visual Studio Code Extension repository | marketplace
• ICSharpCode.Decompiler NuGet for your own projects
• Linux/Mac/Windows command line client - check out ICSharpCode.Decompiler.Console in this repository
• Linux/Mac/Windows PowerShell cmdlets in this repository

Features

• Decompilation to C#
• Whole-project decompilation (csproj, not sln!)
• Search for types/methods/properties (substring)
• Hyperlink-based type/method/property navigation
• Base/Derived types navigation, history
• BAML to XAML decompiler
• Extensible via plugins (MEF)
• Check out the language support status

License

ILSpy is distributed under the MIT License.

Included open-source libraries:

• Mono.Cecil: MIT License (part of ICSharpCode.Decompiler)
• LightJson: MIT License (part of ICSharpCode.Decompiler)
• Humanizer: MIT License (part of ICSharpCode.Decompiler)
• AvalonEdit: MIT License
• SharpTreeView: LGPL
• Ricciolo.StylesExplorer: MS-PL (part of ILSpy.BamlDecompiler.Plugin)
• CommandLineUtils: Apache License 2.0 (part of ICSharpCode.Decompiler.Console)

How to build

Windows:

• Check out the repository using git.
• Execute git submodule update --init --recursive to get all required submodules.
• Use ILSpy.sln to work.

(Optional, Windows-only) Note: If you want to use the same build configuration as the build server, you will have to install VC++ 2017 version 15.7 v14.14 latest v141 tools (or similar) from the "Individual components" section in the Visual Studio Setup. We use editbin.exe to modify the stack size used by ILSpy.exe from 1MB to 16MB, because the decompiler makes heavy use of recursion, where small stack sizes lead to problems in very complex methods.

Unix:

• Check out the repository using git.
• Execute git submodule update --init --recursive to get all required submodules.
• Edit \ICSharpCode.Decompiler\ICSharpCode.Decompiler.csproj Add Sdk="Microsoft.NET.Sdk" to the Project element. This is required due to a tooling issue on Unix. Please do not commit this when contributing a pull request!
• Use Frontends.sln to work.

How to contribute

• Report bugs
• If you want to contribute a pull request, please add https://gist.github.com/siegfriedpammer/75700ea61609eb22714d21885e4eb084 to your .git/hooks to prevent checking in code with wrong indentation. We use tabs and not spaces. The build server runs the same script, so any pull requests using wrong indentation will fail.

Current and past contributors.