.NET Decompiler with support for PDB generation, ReadyToRun, Metadata (&more) - cross-platform!
Go to file
Siegfried Pammer b629cdb603
Merge pull request #3138 from ltrzesniewski/dark-theme-highlighting
Adjust colors of AvalonEdit built-in highlightings for dark themes
2024-02-26 18:55:36 +01:00
.github Bump actions/upload-artifact from 3 to 4 (#3146) 2024-01-11 07:26:27 +01:00
BuildTools Enable auto-formatting in commit-hook. 2023-05-28 13:59:43 +02:00
ICSharpCode.Decompiler Fix #3153: Always use SHA1 for public key tokens. According to ECMA-335, the hash algorithm stored in the assembly metadata is intended for file content verification purposes, not identification purposes. 2024-01-20 15:49:48 +01:00
ICSharpCode.Decompiler.PowerShell Apply Central package management (requires package source mapping) (#3124) 2023-11-23 07:25:23 +01:00
ICSharpCode.Decompiler.TestRunner Move to .NET 8.0 (#3119) 2023-11-17 20:23:38 +01:00
ICSharpCode.Decompiler.Tests Migrate to NUnit 4 (#3132) 2023-12-02 13:38:55 +01:00
ICSharpCode.ILSpyCmd Apply Central package management (requires package source mapping) (#3124) 2023-11-23 07:25:23 +01:00
ICSharpCode.ILSpyX Merge pull request #3149 from icsharpcode/pdb+dmeta 2024-01-04 20:33:27 +01:00
ILSpy Merge pull request #3138 from ltrzesniewski/dark-theme-highlighting 2024-02-26 18:55:36 +01:00
ILSpy-tests@6f8860e420 Add test configuration for mcs 5.23.0 2021-11-17 22:18:43 +01:00
ILSpy.AddIn Apply Central package management (requires package source mapping) (#3124) 2023-11-23 07:25:23 +01:00
ILSpy.AddIn.Shared Adapt GetILSpyPath and copy both x64 and arm64 ILSpy into the VSIX for VS 2022 2023-06-14 12:26:33 +02:00
ILSpy.AddIn.VS2022 Apply Central package management (requires package source mapping) (#3124) 2023-11-23 07:25:23 +01:00
ILSpy.BamlDecompiler Apply Central package management (requires package source mapping) (#3124) 2023-11-23 07:25:23 +01:00
ILSpy.BamlDecompiler.Tests Migrate to NUnit 4 (#3132) 2023-12-02 13:38:55 +01:00
ILSpy.Installer NuGet package updates 2024-02-18 09:34:35 +01:00
ILSpy.ReadyToRun Apply Central package management (requires package source mapping) (#3124) 2023-11-23 07:25:23 +01:00
ILSpy.Tests Migrate to NUnit 4 (#3132) 2023-12-02 13:38:55 +01:00
SharpTreeView Apply Central package management (requires package source mapping) (#3124) 2023-11-23 07:25:23 +01:00
TestPlugin Move to .NET 8.0 (#3119) 2023-11-17 20:23:38 +01:00
doc Change info across the board to -2023 2023-01-05 12:36:01 +01:00
.editorconfig #2128: change .editorconfig according to our new code style. 2020-08-28 00:31:38 +02:00
.git-blame-ignore-revs #2128: Add .git-blame-ignore-revs 2020-08-28 01:06:48 +02:00
.gitattributes Add .gitattributes and normalize newlines 2013-10-01 15:43:18 +02:00
.gitignore PowerShell module manifest (#2976) 2023-04-27 17:41:04 +02:00
.gitmodules Remove AD submodule. 2019-11-17 21:53:39 +01:00
.tgitconfig Add tgit.icon project config 2014-04-06 11:37:14 +08:00
.vsconfig Update README.md for our new net60 target. Fixes #2647 2022-04-05 13:11:08 +02:00
Directory.Packages.props NuGet package updates 2024-02-18 09:34:35 +01:00
ILSpy.Installer.sln Make Installer top-level solution and build it post-publish of ILSpy.sln (#2991) 2023-05-29 16:55:44 +02:00
ILSpy.VSExtensions.sln Move VS Extensions projects to a separate solution 2023-06-14 12:12:15 +02:00
ILSpy.Wpf.slnf PdbProvider.Cecil no longer exists (-> ILSpyX) 2022-06-19 18:37:20 +02:00
ILSpy.XPlat.slnf Rename ics.d.Console to ics.ILSpyCmd 2022-04-07 15:49:47 +02:00
ILSpy.sln Move VS Extensions projects to a separate solution 2023-06-14 12:12:15 +02:00
NuGet.config Migrate to NUnit 4 (#3132) 2023-12-02 13:38:55 +01:00
README.md Fix #3129 (build instructions) 2023-11-25 10:31:39 +01:00
clean.bat Use VS2022 when building with the .bat files 2022-03-21 20:55:32 +01:00
debugbuild.bat Use VS2022 when building with the .bat files 2022-03-21 20:55:32 +01:00
decompiler-nuget-demos.ipynb Update Notebook for 8.1 2023-08-04 14:33:25 +02:00
global.json Move to .NET 8.0 (#3119) 2023-11-17 20:23:38 +01:00
publish.ps1 Move to .NET 8.0 (#3119) 2023-11-17 20:23:38 +01:00
releasebuild.bat Use VS2022 when building with the .bat files 2022-03-21 20:55:32 +01:00

README.md

ILSpy NuGet Build ILSpy Mastodon Follow Twitter Follow ILSpy VS extension

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

Download: latest release | latest CI build (master) | Microsoft Store (RTM versions only)

Decompiler Frontends

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

  • Visual Studio 2022 ships with decompilation support for F12 enabled by default (using our engine v8.1).
  • In Visual Studio 2019, you have to manually enable F12 support. Go to Tools / Options / Text Editor / C# / Advanced and check "Enable navigation to decompiled source"
  • C# for Visual Studio Code ships with decompilation support as well. To enable, activate the setting "Enable Decompilation Support".
  • Our Visual Studio 2022 extension marketplace
  • Our Visual Studio 2017/2019 extension marketplace
  • Our Visual Studio Code Extension repository | marketplace
  • Our Linux/Mac/Windows ILSpy UI based on Avalonia - check out https://github.com/icsharpcode/AvaloniaILSpy
  • Our ICSharpCode.Decompiler NuGet for your own projects
  • Our dotnet tool for Linux/Mac/Windows - check out ILSpyCmd in this repository
  • Our Linux/Mac/Windows PowerShell cmdlets in this repository

Features

  • Decompilation to C# (check out the language support status)
  • Whole-project decompilation
  • Search for types/methods/properties (learn about the options)
  • Hyperlink-based type/method/property navigation
  • Base/Derived types navigation, history
  • Assembly metadata explorer (feature walkthrough)
  • BAML to XAML decompiler
  • ReadyToRun binary support for .NET Core (see the tutorial)
  • Extensible via plugins
  • Additional features in DEBUG builds (for the devs)

License

ILSpy is distributed under the MIT License. Please see the About doc for details, as well as third party notices for included open-source libraries.

How to build

Windows:

  • Make sure PowerShell (at least version) 5.0 is installed.
  • Clone the ILSpy repository using git.
  • Execute git submodule update --init --recursive to download the ILSpy-Tests submodule (used by some test cases).
  • Install Visual Studio (documented version: 17.8). You can install the necessary components in one of 3 ways:
    • Follow Microsoft's instructions for importing a configuration, and import the .vsconfig file located at the root of the solution.
    • Alternatively, you can open the ILSpy solution (ILSpy.sln) and Visual Studio will prompt you to install the missing components.
    • Finally, you can manually install the necessary components via the Visual Studio Installer. The workloads/components are as follows:
      • Workload ".NET Desktop Development". This workload includes the .NET Framework 4.8 SDK and the .NET Framework 4.7.2 targeting pack, as well as the .NET 8.0 SDK (ILSpy.csproj targets .NET 6.0, but we have net472 projects too). Note: The optional components of this workload are not required for ILSpy
      • Workload "Visual Studio extension development" (ILSpy.sln contains a VS extension project) Note: The optional components of this workload are not required for ILSpy
      • Individual Component "MSVC v143 - VS 2022 C++ x64/x86 build tools" (or similar)
        • The VC++ toolset is optional; if present it is used for 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.
    • Open ILSpy.sln in Visual Studio.
      • NuGet package restore will automatically download further dependencies
      • Run project "ILSpy" for the ILSpy UI
      • Use the Visual Studio "Test Explorer" to see/run the tests
      • If you are only interested in a specific subset of ILSpy, you can also use
        • ILSpy.Wpf.slnf: for the ILSpy WPF frontend
        • ILSpy.XPlat.slnf: for the cross-platform CLI or PowerShell cmdlets
        • ILSpy.AddIn.slnf: for the Visual Studio plugin

Note: Visual Studio includes a version of the .NET SDK that is managed by the Visual Studio installer - once you update, it may get upgraded too. Please note that ILSpy is only compatible with the .NET 6.0 SDK and Visual Studio will refuse to load some projects in the solution (and unit tests will fail). If this problem occurs, please manually install the .NET 6.0 SDK from here.

Unix / Mac:

  • Make sure .NET 8.0 SDK is installed.
  • Make sure PowerShell is installed (formerly known as PowerShell Core)
  • Clone the repository using git.
  • Execute git submodule update --init --recursive to download the ILSpy-Tests submodule (used by some test cases).
  • Use dotnet build ILSpy.XPlat.slnf to build the non-Windows flavors of ILSpy (.NET Core Global Tool and PowerShell Core).

How to contribute

Current and past contributors.

Privacy Policy for ILSpy

ILSpy does not collect any personally identifiable information, nor does it send user files to 3rd party services. ILSpy does not use any APM (Application Performance Management) service to collect telemetry or metrics.