FrameAssembly v1.5.1 · Linux, macOS, Windows & Web
Install FrameAssembly
Install frameassembly v1.5.1 and the VS Code extension on Linux, macOS, or Windows—or compile and decompile .pcap / .pcapng files right in your browser.
Option 1 · Run in Your Browser
FrameAssembly Playground (No Install Required)
Write or pick an example script, inspect the packets, and click Download .pcapng to open in Wireshark.
Option 2 · Local Package Managers & VS Code Extension (v1.5.1)
Install on Your Machine
Rust Cargo (Recommended for Easy Updates) & VS Code Extension
Installing via Cargo is the recommended way to install and update FrameAssembly across Linux, macOS, and Windows. If you do not have the Rust toolchain (cargo) installed yet, install rustup first in one command, then run cargo install frameassembly.
1a. Don’t have Rust yet? Install Rust & Cargo on Linux, macOS, or WSL (rustup):
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && . "$HOME/.cargo/env"
1b. Or install Rust & Cargo on Windows 10 / 11 (PowerShell / WinGet):
winget install --id Rustlang.Rustup -e
2. Install or update FrameAssembly via Cargo:
cargo install frameassembly
3. Official VS Code / Cursor Syntax Highlighting Extension:
code --install-extension SteveWinschel.frameassembly-vscode
Inspect packets (
frameassembly show), compile a .pcap, or decompile an existing capture (frameassembly reverse):# 1. Preview the packet ladder directly in your terminal (no .pcap file written)
frameassembly show demo.fasm
# 2. Compile a .pcap file from your .fasm recipe (writes demo.pcap by default, or pass -o)
frameassembly demo.fasm -o output.pcap
# 3. Decompile an existing .pcap or .pcapng back into editable .fasm code (new in v1.5.1)
frameassembly reverse output.pcap -o sanitized.fasm
# 4. Inspect in Wireshark / tshark or replay onto a test port
tshark -r output.pcap
sudo tcpreplay -i eth0 output.pcap