byteplay rev 0.2.0
packet field manual — open source, MIT

See every byte on the wire.
Mark it up. Send it back out.

byteplay captures raw TCP/UDP traffic, lets you edit it byte-by-byte in a hex view, and replays the result against your own service — so you can see exactly what it does with input you designed, not just input it expected.

Windows · macOS (Apple Silicon) · Linux — native installers, no runtime to set up

0 8 16 24 31 SRC PORT 4d 1a DST PORT 01 bb SEQ NUMBER 8f 22 0c 4e FLAGS PSH ACK EDITED — seq rewritten before replay CAPTURED off wire, raw socket REPLAYED to 127.0.0.1:8080 DOC byteplay REV 0.2.0 PROTO TCP/UDP LIC MIT
§1 — capabilities

The full loop, not half of it

Most tools stop at reading traffic or stop at sending it. byteplay carries one packet through capture, edit, and replay without switching tools.

capture

Live packet capture

Raw-socket capture with a virtualized list, BPF-style filters, and rolling per-minute stats. A 50k-packet ring buffer keeps the view instant under load.

hex / diff

Byte-level editing

Dual-pane hex and ASCII view with a visual diff against the original capture, so you always know exactly which bytes you changed before you send.

replay

Raw TCP/UDP replay

Resend a captured or edited packet to any host and port. Protocol-agnostic — byteplay works below the application layer, not just over HTTP.

fuzz

Mutation fuzzing

A deterministic, seeded fuzzer mutates a payload and replays each variant with live progress and a cancel button. Bounded runs, reproducible seeds.

sequence

Replay sequences

Chain several packets into a scripted session with a delay and timeout on each step — for reproducing a handshake or a multi-step exchange exactly.

library

Packet library

Save and tag packets in a local SQLite library with full replay history, plus export to PCAP or JSON when you need to hand a capture to someone else.

§2 — comparison

Where byteplay sits

Wireshark reads. Burp edits HTTP. Scapy scripts anything. byteplay is the GUI that does capture-edit-replay on the raw wire.

capability matrix — packet tooling
Capability Wireshark Burp Suite Scapy byteplay
Packet capture & analysis yes no yes yes
Edit bytes, then resend no no yes yes
Protocol-agnostic (raw TCP/UDP) no HTTP only yes yes
GUI, no scripting required yes yes no yes
Mutation fuzzer + sequences no no yes yes
Persistent packet library no no no yes
$ session log — capture → edit → replay

> capture eth0 — 3,214 packets · 1.8 MB · 62% tcp / 38% udp

$ open packet #12, field: seq
> 8f 22 0c 4e00 00 00 00 — 4 bytes changed, diff shown inline

$ replay to 127.0.0.1:8080
> sent 66 bytes — 200 OK, 2ms

$ fuzz --seed 4471 --iterations 10000
> done in 4m 12s — 3 anomalies flagged, run saved to library
§3 — download

Get byteplay 0.2.0

Free forever, MIT licensed. No account, no telemetry — nothing leaves the machine it runs on.

windows · x64

Windows

  • NSIS installer or MSI
  • Requires Npcap for capture
Download .exe
macos · aarch64

macOS

  • Apple Silicon build
  • Requires Xcode CLT for capture
Download .dmg
linux · amd64

Linux

  • Debian package or AppImage
  • Requires libpcap
Download .deb

Not sure which file? Open the full release page — Windows needs Npcap installed before it can capture traffic.

§4 — safety rails

Responsible by default

Packet crafting can do real damage pointed at the wrong target. byteplay keeps the guardrails on until you take them off yourself.

default

Replay and fuzz targets are restricted to localhost and private ranges (RFC 1918) out of the box.

opt-in

Sending to an external target needs an explicit Allow external checkbox, set per session.

local-only

Everything lives in a local SQLite database. Zero telemetry, zero cloud — nothing phones home.

audited

Every replay is logged locally with a timestamp, target, and payload hash, so you can always retrace a run.

your call

MIT licensed for use against systems you own or are explicitly authorized to test — the tool doesn't check, so you have to.

§5 — build status

Shipping, tested, open

current release
0.2.0

Signed installers published for Windows, macOS, and Linux.

automated tests
41 rust / 13 ui

Parsing, capture, replay, fuzzing, storage, and IPC contracts. CI runs on every push, across 3 OSes.

quality gates
green

clippy -D warnings, rustfmt, eslint, tsc, and prettier — all enforced in CI, none optional.

license
MIT

Free to use, modify, and redistribute. Contributions and issues welcome on GitHub.