straithe / packetry

Packetry

A fast, intuitive USB 2.0 protocol analysis application for use with LUNA.

Packetry is currently in active development and not yet ready for initial release.

Development

Packetry is written in Rust, with its GUI using GTK 4 via the gtk-rs bindings.

To build it, you need a working Rust development environment. The minimum supported Rust version is 1.57.

You must also have the GTK 4 headers installed and discoverable via pkg-config, as this is required for Rust to build the gtk-rs crates.

Building and running

To build, run cargo build after installing the necessary prerequisites (see below). Run with cargo run.

If you pass a capture filename as an argument, Packetry will attempt to load it. The current supported file format is a .pcap file with the LINKTYPE_USB_2_0 link layer header type.

If no filename is provided, Packetry will attempt to start live capture from an attached device running the LUNA USB analyzer applet.

Installing prerequisites

Linux

Install the Rust build tools, other essential build tools, and GTK 4 headers.

On Debian based systems it should be sufficient to use the command:

apt install rustc cargo build-essential libgtk-4-dev

For Fedora systems:

yum install rust cargo make gcc gcc-c++ gtk4-devel pango-devel

For other distributions, a similar set of packages should be required.

You can also omit Rust and Cargo and use rustup to get the latest Rust toolchain and manage your Rust installation.

macOS

Install Rust with rustup, and install Homebrew.

Install GTK 4 with brew install gtk4.

Windows

Follow the installation instructions from GUI development with Rust and GTK 4.

You can use either the MSVC or GNU toolchains.