TraceWrangler - Packet Capture Toolkit

Introduction

TraceWrangler is a network capture file toolkit running on Windows (or on Linux, using WINE) that supports PCAP as well as the new PCAPng file format, which is now the standard file format used by Wireshark. The most prominent use case for TraceWrangler is the easy sanitization and anonymization of PCAP and PCAPng files (sometimes called "trace files", "capture files" or "packet captures"), removing or replacing sensitive data while being easy to use.

Features

utility to read, write and modifiy PCAPng files
Sanitization/Anonymization/Scrubbing of packet captures created by Wireshark/TCPDump/etc.
Editing packets in batch, especially by removing certain protocol layers like MPLS, GRE or GTP-u, or to convert Linux cooked captures to Pseudo-Ethernet
Merging capture files, especially PCAPng files with more than one interface and using filters to keep only certain frames
Gathering and aggregating packet details about a large number of capture files, like IP, TCP and UDP conversations
Displaying the PCAPng specific block structure of a file
extracting conversations from multiple files to new capture files, based on manual filters, capture file indicator frames, or Snort alerts

Screenshot

Download

Created: September 4, 2024

32bit version: TraceWrangler Beta 0.6.9 build 975
MD5 (32bit zip): 5813b2c678418328e343c844e2182487

64bit version: TraceWrangler Beta 0.6.9 build 975
MD5 (64bit zip): e811b0215c070c4d0678e986fe030c09

Source Code: TraceWranglerSrc_0.6.8.zip

There is also a semi-automated build section where you can download current builds. Those builds are usually working better than the latest stable release, but in some cases features may not be implemented completely yet, or still broken. Also, the documentation isn't up to date.

My GPG public key can be found here

Documentation

Documentation is available online, as well as a Windows help file inside the download container. There also is a PDF File.

Presentations

You can also take a look at my presentation I did about anonymizing network packet trace files at Sharkfest 2013.

Changelog and Updates

There is a ChangeLog available, listing all the changes for published versions. Updated versions will also be announced via twitter (@packetjay). There is also a RSS feed available.

Feedback and Known Issues

Sent feedback about bugs, feature requests and other topics to "jasper [ät] packet-foo.com". My PGP key is found here.

If you sent bug reports, please include

a description of how to reproduce the problem
a short sample trace, if possible
the .task file you used, if you still have it.

TraceWrangler has some limitations at the moment (which may most likely last a little longer than just "a moment"):

The maximum trace file size is less than 2GBytes. This limitation is a result of the way the files are read by using Memory Mapped files. I'll work on this "when there is time"^tm.
Capture files that contain truncated or damaged frames may not work under all circumstances. I recommend using captures that contain full sized frames. Reason for this is that I may have been lazy in some parts of the code where I do sanity checks against the length of the data available for processing, which is a great way to run some pointers into the great beyond. Ouch.
IPv6 checksums may not be calculated correctly when extension headers (including fragmentation headers) are used in a frame.

Thanks, and have fun,
Jasper