An open API service indexing awesome lists of open source software.

https://github.com/gabrielweyer/pe-clr-viewer

Probably the ugliest web app in the world!
https://github.com/gabrielweyer/pe-clr-viewer

angular azure-static-web-apps github-actions portable-executable

Last synced: about 1 year ago
JSON representation

Probably the ugliest web app in the world!

Awesome Lists containing this project

README

          

# Portable Executable CLR Viewer

[![Build Status][github-actions-shield]][github-actions]

I was reading through the second chapter of [Advanced .NET Debugging][advanced-dotnet-debugging-book] and didn't manage to find the entry point of an executable. I wrote this web application so that `a)` I could understand more about the [PE format][pe-format] and `b)` I wouldn't have to repeat the same basic math each time I wanted to inspect a `.NET` `DLL`.

> `Portable Executable CLR Viewer` is a hex viewer for `.NET` binaries.

At the moment it's fairly limited and only highlights:

- The bitness (`x86` vs `x64`)
- The entry point `Relative Virtual Address` (search for `RVA` in the [PE format][pe-format])
- The [CLI flags][cli-flags]
- The targeted `CLR` version

If you feel adventurous you can try the [hosted version][pe-clr-viewer].

**Fair warning**: this is probably the ugliest web app in the world :joy_cat:.

This is very much a **work in progress**. If I manage to motivate myself I'll work on the cards listed in this [public Trello board][trello-board].

## Running locally

If you would like to inspect a proprietary binary I advise you to run locally (the app is self-contained). You'll need:

- [Latest Node.js LTS][node-js]
- [Yarn modern][yarn-modern]

Then run the following commands one by one:

```shell
yarn install
yarn start
```

## CI/CD

Each push to `main` triggers a `GitHub Actions` workflow and a deployment to `Azure Static Web Apps`.

[advanced-dotnet-debugging-book]: https://www.goodreads.com/book/show/7306509-advanced-net-debugging
[pe-format]: https://msdn.microsoft.com/library/windows/desktop/ms680547(v=vs.85).aspx
[pe-clr-viewer]: https://purple-flower-051c59f00.2.azurestaticapps.net
[trello-board]: https://trello.com/b/7b21MQqD/open-source?filter=label:pe-clr-viewer
[node-js]: https://nodejs.org/en/download/
[yarn-modern]: https://yarnpkg.com/getting-started/install
[cli-flags]: http://source.roslyn.codeplex.com/#System.Reflection.Metadata/System/Reflection/PortableExecutable/CorFlags.cs,1b8345c412a0a995
[github-actions-shield]: https://github.com/gabrielweyer/pe-clr-viewer/actions/workflows/workflow.yml/badge.svg
[github-actions]: https://github.com/gabrielweyer/pe-clr-viewer/actions/workflows/workflow.yml