https://github.com/washi1337/asmresolver
A library for creating, reading and editing PE files and .NET modules.
https://github.com/washi1337/asmresolver
assembler cil disassembler dotnet il malware-analysis msil parser pe portable-executable reader reverse-engineering writer
Last synced: 5 months ago
JSON representation
A library for creating, reading and editing PE files and .NET modules.
- Host: GitHub
- URL: https://github.com/washi1337/asmresolver
- Owner: Washi1337
- License: mit
- Created: 2013-02-20T14:07:25.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2025-05-12T08:48:21.000Z (5 months ago)
- Last Synced: 2025-05-16T10:07:26.953Z (5 months ago)
- Topics: assembler, cil, disassembler, dotnet, il, malware-analysis, msil, parser, pe, portable-executable, reader, reverse-engineering, writer
- Language: C#
- Homepage: https://docs.washi.dev/asmresolver/
- Size: 9.45 MB
- Stars: 953
- Watchers: 37
- Forks: 133
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# AsmResolver
[](https://ci.appveyor.com/project/Washi1337/asmresolver/branch/master)
[](https://www.nuget.org/packages/AsmResolver/)
[](https://opensource.org/licenses/MIT)
[](https://discord.gg/Y7DTBkbhJJ)
AsmResolver is a library for reading, modifying and reconstructing Portable Executable (PE) files. It supports PE images running natively on Windows, as well as images containing managed (.NET) metadata.
AsmResolver is released under the MIT license.
## Main Features
AsmResolver has a lot of features. Below is a non-exhaustive list of the highlights:
- [x] Create, read, modify, write and patch PE files.
- [x] Full access to sections, data directories and their interpretations.
- [x] Import Address Table (IAT) reconstruction and trampolining.
- [x] Full control over the layout of the final PE file output.
- [x] Rich support for various Win32 resource types.
- [x] Rich support for .NET metadata with an intuitive API similar to `System.Reflection`.
- [x] Managed, native and dynamic method body support.
- [x] Easy metadata importing and cloning.
- [x] Managed resource file serializers and deserializers.
- [x] Support for AppHost / SingleFileHost bundles.
- [x] Support for ReadyToRun (R2R) binaries.
- [x] Rich read support for PDB and PortablePdb symbols.
- [x] Fully managed cross-platform API (No DIA or similar required).
- [x] .NET 3.5 compatible.
- [x] Cross-platform (Windows and *nix, .NET standard 2.0 and Mono compatible).
- [x] Documented.
- [x] Unit tested.
## Documentation
- [Guides](https://docs.washi.dev/asmresolver)
- [API Reference](https://docs.washi.dev/asmresolver/api/core/AsmResolver.html)
## Support
- [Issue Tracker](https://github.com/Washi1337/AsmResolver/issues)
- [Discussion Board](https://github.com/washi1337/asmresolver/discussions)
- [Discord](https://discord.gg/Y7DTBkbhJJ)
## Binaries
Stable Builds:
- [NuGet Feed](https://www.nuget.org/packages/AsmResolver/)
- [GitHub Releases](https://github.com/Washi1337/AsmResolver/releases)
Nightly Builds:
- [AppVeyor](https://ci.appveyor.com/project/Washi1337/asmresolver/build/artifacts)
- [Nightly Nuget Feed](https://nuget.washi.dev/)
| Branch | Build status |
|--------|--------|
| master | [](https://ci.appveyor.com/project/Washi1337/asmresolver/branch/master) |
| development | [](https://ci.appveyor.com/project/Washi1337/asmresolver/branch/development)
## Compiling
The solution can be built using the .NET SDK or an IDE that works with it (e.g., Visual Studio and JetBrains Rider). The main packages target LTS versions of various .NET runtimes (.NET 3.5, .NET Standard 2.0, .NET Standard 2.1, .NET Core 3.1, .NET 6.0, .NET 8.0).
To build the project from the command line, use:
```bash
$ dotnet build
```
To run all tests, use:
```bash
$ dotnet test
```
For running the tests successfully, you will need to have additional versions of .NET installed (including STS versions or versions declared EOL), as the unit tests verify reading binaries targeting various .NET runtimes.
To run the tests successfully on MacOS and Linux, `mono` and `wine` are expected to be installed as well.
## Contributing
- See [CONTRIBUTING.md](CONTRIBUTING.md).
## Acknowledgments
AsmResolver started as a hobby project but has grown into a community project with various contributors. Without these people, AsmResolver would not have been where it is today!
- Special thanks to all the people who contributed [directly with code commits](https://github.com/Washi1337/AsmResolver/graphs/contributors) or monetarily via [GitHub sponsors](https://github.com/sponsors/Washi1337).
- Special thanks to the people at [@MonoMod](https://github.com/MonoMod) for helping with .NET 3.5 compatibility.
- Another big thank you to all the people that suggested new features, provided feedback on the API design, have done extensive testing, and/or reported bugs on the [issue board](https://github.com/Washi1337/AsmResolver/issues), by e-mail, or through DMs.
If you feel you have been under-represented in these acknowledgments, feel free to reach out.