Skip to content

Trippy - Network Diagnostic Tool Cheatsheet

Trippy - Network Diagnostic Tool Cheatsheet

trippy (binary: trip) is a Rust network diagnostic tool that fuses traceroute and ping into a single live TUI. For every hop it shows packets sent/received, loss %, and last/avg/best/worst/stddev latency, plus jitter analysis, histograms, GeoIP, and DNS resolution. It supports ICMP, UDP, and TCP probes and can trace multiple targets at once — making it far faster to answer “where is the network breaking?” than classic traceroute + ping.

Installation

PlatformCommand
Cargo (all platforms)cargo install trippy
macOS (Homebrew)brew install trippy
Arch Linuxsudo pacman -S trippy
Debian/Ubuntusudo apt install trippy
Fedorasudo dnf install trippy
Nixnix-env -iA nixpkgs.trippy
Windows (Scoop)scoop install trippy

Privileges

ICMP/raw sockets need elevated rights:

sudo trip example.com
# Or grant the capability once (Linux), then run without sudo:
sudo setcap cap_net_raw+ep $(which trip)

Basic Usage

CommandDescription
trip example.comTrace + ping a host (ICMP, live TUI)
trip example.com google.comTrace multiple targets at once
trip 1.1.1.1Trace an IP directly
trip --helpFull option list
trip --versionVersion

Protocol & Probe Options

OptionDescription
-i, --interface eth0Use a specific source interface
--icmpICMP probes (default)
--udpUDP probes
--tcpTCP probes (good through firewalls)
-p, --target-port 443Target port (UDP/TCP)
--first-ttl NStart at a given TTL
--max-ttl NMaximum number of hops
-4 / -6Force IPv4 / IPv6

Timing & Rate

OptionDescription
--min-round-duration 100msMinimum time per round
--max-round-duration 1sMaximum time per round
--initial-sequence NStarting sequence number
--read-timeout 1sPer-probe read timeout
--grace-duration 100msWait for late responses

DNS & GeoIP

OptionDescription
-r, --dns-resolve-method systemResolver: system, resolv, google, cloudflare
-z, --dns-lookup-as-infoShow the AS (autonomous system) number per hop
--dns-resolve-allResolve all IPs for a host
--geoip-mmdb-file GeoLite2-City.mmdbAdd city/country GeoIP per hop

Interactive Keys

KeyAction
/ Select a hop
TabSwitch between targets
zToggle the hop chart
hToggle help
qQuit
EscClose a panel

Reports (Non-Interactive)

trippy can emit one-shot reports for scripts and tickets.

CommandDescription
trip example.com -m reportPrint a table report and exit
trip example.com -m jsonJSON output
trip example.com -m csvCSV output
trip example.com -m streamContinuous text stream
trip example.com -m flowsShow distinct routing flows (ECMP)

Common Workflows

# Where is the latency? Trace with AS info and a 30-hop cap
sudo trip example.com -z --max-ttl 30

# Diagnose through a firewall that drops ICMP
sudo trip example.com --tcp -p 443

# Compare two upstreams side by side
sudo trip 1.1.1.1 8.8.8.8

# Capture a report to attach to a support ticket
sudo trip example.com -m json > trace-report.json

Trippy vs Classic Tools

ToolCombines ping+tracerouteMulti-targetTUIProtocols
trippyYesYesRichICMP/UDP/TCP
mtrYesNoBasicICMP/UDP
tracerouteNoNoNoICMP/UDP/TCP
pingNoNoNoICMP

Resources