.NET Decompiler with support for PDB generation, ReadyToRun, Metadata (&more) - cross-platform!
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Siegfried Pammer 1659b8e956 Rename the preview-tab 'pin' concept to 'freeze' 4 weeks ago
.github Bump dessant/lock-threads from 6.0.0 to 6.0.2 1 month ago
.vscode Add VSCode launch config. 11 months ago
BuildTools Build ICSharpCode.Decompiler.Tests + the format hook cross-platform 4 weeks ago
ICSharpCode.BamlDecompiler Updates for .NET Preview 4 2 months ago
ICSharpCode.Decompiler Bump version to 11.0-preview1 4 weeks ago
ICSharpCode.Decompiler.PowerShell Remove WPF ILSpy host (prep for Avalonia rewrite) 4 weeks ago
ICSharpCode.Decompiler.TestRunner .NET 11 for Tests (#3695) 3 months ago
ICSharpCode.Decompiler.Tests Build ICSharpCode.Decompiler.Tests + the format hook cross-platform 4 weeks ago
ICSharpCode.ILSpyCmd Replace ISettingsFilePathProvider with Func<string> and move IResourceFileHandler to ILSpyX. 4 weeks ago
ICSharpCode.ILSpyX Show About page and seed running framework on first run 4 weeks ago
ILSpy Rename the preview-tab 'pin' concept to 'freeze' 4 weeks ago
ILSpy-tests@6cc4bb2942 Hide compiler-generated InlineArray types. 1 year ago
ILSpy.AddIn .NET 11 for Tests (#3695) 3 months ago
ILSpy.AddIn.Shared Fix IDE2000 globally 6 months ago
ILSpy.AddIn.VS2022 .NET 11 for Tests (#3695) 3 months ago
ILSpy.BamlDecompiler.Tests Remove WPF ILSpy host (prep for Avalonia rewrite) 4 weeks ago
ILSpy.Installer Installer NuGet updates (and link to Wix7 issue) 2 months ago
ILSpy.ReadyToRun Port ILSpy.ReadyToRun plugin 4 weeks ago
ILSpy.Tests Rename the preview-tab 'pin' concept to 'freeze' 4 weeks ago
ILSpy.Tests.Windows Add per-step visual breakpoints to the headless UI tests 4 weeks ago
TestFixtures.Resources Add TestFixtures.Resources project for manual resource-view tests 4 weeks ago
TestPlugin Do not use ObservableObject when ObservableObjectBase is sufficient. (#3644) 6 months ago
doc Cross-platform ImageList decoder + FORMAT.md 4 weeks ago
.editorconfig Migrate from .ruleset to .editorconfig 6 months ago
.git-blame-ignore-revs #2128: Add .git-blame-ignore-revs 6 years ago
.gitattributes Add .gitattributes and normalize newlines 13 years ago
.gitignore dev: expand .vscode/ exclusion in .gitignore 11 months ago
.gitmodules update submodule 1 year ago
.tgitconfig Add tgit.icon project config 12 years ago
CLAUDE.md Drop the area-prefix convention from the commit guideline 4 weeks ago
Directory.Build.props Update to C# 13 and fix field keyword 11 months ago
Directory.Packages.props Bump to Avalonia 12.0.3 4 weeks ago
ILSpy.Desktop.slnf Rename ILSpy.Wpf.slnf -> ILSpy.Desktop.slnf with updated contents 4 weeks ago
ILSpy.Installer.sln dev: Strip BOM mark from text files 10 months ago
ILSpy.VSExtensions.sln dev: Strip BOM mark from text files 10 months ago
ILSpy.XPlat.slnf Rename ics.d.Console to ics.ILSpyCmd 4 years ago
ILSpy.sln Port ILSpy.ReadyToRun plugin 4 weeks ago
LICENSE Move license.txt to root folder LICENSE file 2 years ago
NuGet.config .NET 11 for Tests (#3695) 3 months ago
README.md Simplify "How to build" section, fix indentation on "Open ILSpy.sln in Visual Studio" 7 months ago
SECURITY.md Create SECURITY.md 2 years ago
clean.bat Fix up clean.bat as well to use dotnet 11 months ago
debugbuild.bat Update System.Reflection.Metadata dependency to 9.0.0. 11 months ago
decompiler-nuget-demos.ipynb Update Notebook for 8.1 3 years ago
global.json .NET 11 for Tests (#3695) 3 months ago
publish.ps1 Upgrade dotnet target framework to net10 1 year ago
publishlocaldev.ps1 Upgrade dotnet target framework to net10 1 year ago
releasebuild.bat Update System.Reflection.Metadata dependency to 9.0.0. 11 months ago
restore.bat Introduce version variables for often-used package version 3 months ago
updatedeps.bat Remove explicit PackageReference to NetAnalyzers again 6 months ago

README.md

ILSpy NuGet Build ILSpy Mastodon Bluesky 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/2026 ship with decompilation support for F12 enabled by default (using our engines v8.2 and v9.1 respectively).
  • Our Visual Studio 2022 extension marketplace (works with VS 2026 as well)
  • Our Visual Studio Code Extension repository | marketplace | open-vsx
  • Our dotnet tool for Linux/Mac/Windows - check out ILSpyCmd in this repository | dotnet tool install
  • C# for Visual Studio Code ships with decompilation support as well. To enable, activate the setting "Enable Decompilation Support".
  • 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"
  • Our Visual Studio 2017/2019 extension marketplace
  • Our ICSharpCode.Decompiler NuGet for your own projects
  • 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 Windows PowerShell (at least version) 5.0 or PowerShell 7+ 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: 18.0/2026). You need the following workload components:
    • 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 10.0 SDK (ILSpy.csproj targets .NET 10.0, but we have net472 projects too).
    • Workload "Visual Studio extension development" (Note: ILSpy.VSExtensions.sln is separate from ILSpy.sln and thus this workload is optional)
    • 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 10.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 10.0 SDK from here.

Unix / Mac:

  • Make sure .NET 10.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.