Skip to content

Repository files navigation

Photon Packet Visualizer

A web UI for inspecting raw Photon Protocol packets pasted from Wireshark (or any other source). The actual decoding is delegated to AutoDruid/photon-parser. A Go library compiled to WebAssembly and called from the browser. This project is only responsible for the UI, the hex/tree linking, and the small WASM wrapper.

Screenshot

Both Photon protocol revisions are supported: v16 and v18.

Prerequisites

mise pins the toolchain so anyone can reproduce the build:

  • Node 24 and pnpm 10.28.2 (pinned in .mise/config.toml)
  • Go (any recent version with GOOS=js GOARCH=wasm support) — required only for rebuilding public/main.wasm

Install everything mise can manage:

mise install
pnpm install

Tasks

The repository defines three mise tasks (see .mise/config.toml):

Task What it does
mise build pnpm build — typecheck + production Vite build into dist/.
mise typecheck vue-tsc --noEmit over the whole project.
mise build-wasm Builds src/parser/main.go to public/main.wasm and copies wasm_exec.js.

Building the WASM parser

To build it (e.g. after bumping photon-parser in src/parser/go.mod):

mise build-wasm

Running locally

pnpm dev

Then open the printed URL. Paste a Wireshark hex dump into the left pane, pick the protocol version in the toolbar, and press Parse (or ⌘/Ctrl+Enter).

  • Split view — input, hex grid, and parse tree side-by-side. Hovering a byte highlights the matching tree node and vice versa; clicking scrolls the other pane.
  • Field breakdown — flat, groupable list of every decoded field, useful when reverse-engineering an unknown command.

Disclaimer

This project is for inspecting and learning the Photon wire format. It does not endorse any specific use; you are responsible for complying with the terms of any service whose traffic you capture or analyze.

About

Web UI for inspecting Photon Protocol packets (GpBinary v16/v18), powered by AutoDruid/photon-parser in WebAssembly.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages