MASM Runner is x86/x64 MASM (Microsoft Macro Assembly Language) code compiler, linker, runner extension for vscode that comes packaged with the Irvine Library and runs on all OS.
This app is made possible through the use of JWlink and JWasm to compile x86/x64 MASM and a 32-bit wine terminal to execute x86 executable binaries on mac and linux (webview) using Boxedwine emscripten port.
This will also compile/link and execute MASM code (x86/x64) natively on windows through the vscode terminal (powershell/cmd) out of the box when the webview is not open on all windows systems.
Please note that this extension is far from perfect, contributions are appreciated.
How To Use
Current commands can be accessed by pressing Ctrl+Shift+p on windows or Command ⌘+shift+p on mac
Starting and Running Code
MASM Runner Webview (CMD terminal) Start
Command: masm runner start
Description: Starts MASM CMD to allow compilation and running of code
Starting Webview
Compile and Run
Command: masm runner compile
Description: Runs code in current file and exports .obj and .exe files to file or workspace directory. Runs code in current file and exports .obj and .exe files to file or workspace directory. When executed this command will either compile/link and run the code:
In the native vscode terminal (Windows Only) running PowerShell, Command Prompt or Git Bash. Note if the webview is open native compiling will NOT occur - supports running x86/x64 (32-bit and 64-bit) MASM.
In the webview - supports running x86 (32-bit) MASM.
Please note if the webview is running (you ran masm runner start) it will compile/link and run in the webview.
Settings (via vscode options):
masmRunner.exportBinaries
Description: Export .exe and .obj from boxedwine webview on compile?
Default Value: True
Running/Compiling/Linking x86 MASM Code in WebviewRunning/Compiling/Linking x86 MASM Code in Native VSCode Terminal
Other Commands and Features
MASM Runner restart
Command: masm runner restart
Description: restarts MASM Runner webview (If this does not work click the terminal and type ctrl+r or Command ⌘+r)
Send File(s) to Webview
Command: masm send file(s) to webview
Description: Send file(s) to MASM Runner Webview
Context Menu: In File explorer you can right click files to send to webview
Settings (via vscode options):
masmRunner.enableContextMenus
Description: Enables context menu in Explorer (used to send files to boxedwine webview (cmd) - Default Value: True)
Default Value: True
Sending files to webview using context menu
Snippets
Current snippets include:
masm-template - Generates standard template to write MASM x86 using Irvine32 library
