https://github.com/scout119/beamdasm

Erlang\Elixir byte code viewer. BEAM file disassembler extension for Visual Studio Code.
https://github.com/scout119/beamdasm

beam beam-files disassembler-extension opcodes visual-studio

Last synced: 9 months ago
JSON representation

Erlang\Elixir byte code viewer. BEAM file disassembler extension for Visual Studio Code.

• Host: GitHub
• URL: https://github.com/scout119/beamdasm
• Owner: scout119
• License: apache-2.0
• Created: 2018-03-30T20:28:29.000Z (about 8 years ago)
• Default Branch: main
• Last Pushed: 2022-12-09T01:02:00.000Z (over 3 years ago)
• Last Synced: 2024-08-08T21:20:02.333Z (over 1 year ago)
• Topics: beam, beam-files, disassembler-extension, opcodes, visual-studio
• Language: TypeScript
• Homepage:
• Size: 6.62 MB
• Stars: 47
• Watchers: 1
• Forks: 12
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
# BEAMdasm

[![GitHub issues](https://img.shields.io/github/issues/scout119/beamdasm.svg)](https://github.com/scout119/beamdasm/issues)

[![GitHub license](https://img.shields.io/github/license/scout119/beamdasm.svg)](https://github.com/scout119/beamdasm/blob/main/LICENSE.md)

[![VS Code marketplace](https://vsmarketplacebadge.apphb.com/installs/Valentin.beamdasm.svg)](https://marketplace.visualstudio.com/items?itemName=Valentin.beamdasm)

[![Join the chat at https://gitter.im/scout119/beamdasm](https://badges.gitter.im/scout119/beamdasm.svg)](https://gitter.im/scout119/beamdasm?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

![GitHub stars](https://img.shields.io/github/stars/scout119/beamdasm.svg?style=social&label=Stars)

BEAM files disassembler extension for Visual Studio Code.

## Description

Erlang\Elixir bytecode viewer.

This extension allows to "peek" inside compiled bytecode for BEAM (Bogdan/Björn Erlang Abstract machine).

## Features

- Dedicated View in the Explorer for all .beam files in the workspace

  - Subitems for main sections:

    - Bytecode instructions (**Code** section)

    - Atoms ('**Atom**' and '**AtU8**' sections)

    - Exported functions ('**ExpT**' section)

    - Imported functions ('**ImpT**' section)

    - Local functions ('**LocT**' section)

    - Strings '**StrT**' section)

    - Attributes ('**Attr**' section)

    - Literals ('**LitT**' section)

- Opcodes, labels and registers color highlighting

- Hover description for opcodes taken from erlang source code (when available)

- Gutter images to indicate start of each function

To activate the extension select "Disassemble BEAM" from the context menu for a .beam file in the Explorer View:

![Activation](media/main.gif)

![Highlight](media/highlight.png)

## Requirements

Visual Studio Code 1.52.0

## Extension Settings

None

## Known Issues

None

## Release Notes

First non-preview release

## Contributing

1. Fork ![Fork Me](https://img.shields.io/github/forks/scout119/beamdasm.svg?style=social&label=Fork%20Me)

2. Create your branch

3. Commit your changes

4. Push to the branch

5. Submit a pull request

## License

[Apache 2.0](LICENSE.md)