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:
| Probe | Target |
|---|---|
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.
| eCapture | eCaptureQ | |
|---|---|---|
| Interface | Command line | Desktop app or Web interface |
| Main task | Capture TLS plaintext; show or save output | Filter, correlate and inspect messages |
| Where it runs | Supported Linux / Android capture machine | Windows, macOS or Linux workstation / Web host |
| Get it | Download eCapture | Download 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:
sudo ecapture tlsUse 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