Skip to content

eCapture ​

See TLS traffic in plaintext with a command-line capture tool powered by eBPF. Run eCapture on a supported Linux or Android capture machine, inspect results and operational logs in your terminal, or write output to files for later analysis.

Capture at the source ​

eCapture observes supported TLS libraries and Go applications without installing a custom CA or changing the target application's code. Use it to investigate requests and responses, troubleshoot encrypted connections, and collect evidence for authorized security analysis.

Choose the probe that matches your application:

ProbeTarget
TLS (tls)Applications using supported OpenSSL or BoringSSL builds
GoTLS (gotls)Applications using Go's TLS implementation
GnuTLS (gnutls)Linux applications linked to GnuTLS

The core TLS modules guide explains library paths and probe options.

Read, save or analyze ​

In eCapture v2.12.0, the three core probes default to text mode with the pcapng source. The collector combines packets from one interface with TLS secrets to reconstruct HTTP/1.x and HTTP/2 messages. It prints messages and runtime logs on stdout. Use -i lo for a local loopback test. To keep the terminal view and also save structured records, add --output stdout --output capture.jsonl.

For offline analysis, -m pcapng --pcapfile capture.pcapng saves packets and TLS secrets together for Wireshark. If you already collect packets separately, -m keylog --keylogfile capture.keys saves the matching secrets. Compare capture modes.

Command line or graphical interface? ​

eCapture collects and decrypts on the capture machine. eCaptureQ provides the graphical analysis interface. To connect eCaptureQ v1.2.0, enable --stream-listen on the v2.12.0 collector. Q subscribes using the ecapture.v2 WebSocket subprotocol. In text mode you can search and correlate decoded messages. In keylog or pcapng mode you can export the native artifact.

eCaptureeCaptureQ
InterfaceCommand lineDesktop app or Web interface
Main taskCapture TLS plaintext; show or save outputFilter, correlate and inspect messages
Where it runsSupported Linux / Android capture machineWindows, macOS or Linux workstation / Web host
Get itDownload eCaptureDownload eCaptureQ

For the listener command and connection settings, see the eCaptureQ quick start.

Start on a supported capture machine ​

Linux supports amd64, arm64 and loong64, with minimum kernels 4.18, 5.5 and 6.6 respectively. Android supports amd64 and arm64. Loading probes requires root or the appropriate Linux capabilities.

Download a build for your system, then follow Getting Started to make your first capture. For an OpenSSL-linked application, the basic command is:

sh
sudo ecapture tls

Use the documentation and ecapture --help for your installed release when choosing options. Advanced usage covers more deployment and output scenarios; architecture and probe development explains the internals.

Official releases · Source and platform requirements · Changelog

eCapture — Overview has loaded

Released under the MIT License.