Trippy

Trippy combines the functionality of traceroute and ping and is designed to assist with the analysis of networking issues.

<img src="https://raw.githubusercontent.com/fujiapple852/trippy/master/assets/0.8.0/trippy.gif" alt="trippy"/>

Navigation

<!-- TOC -->

• Trippy
  • Features
  • Versions
  • Distributions
  • Crates
  • Privileges
  • Usage Examples
  • Command Reference
  • Theme Reference
  • Column Reference
  • Key Bindings Reference
  • Configuration Reference
  • Frequently Asked Questions
  • Acknowledgements
  • License

<!-- TOC -->

Features

• Trace using multiple protocols:
  • ICMP, UDP & TCP
  • IPv4 & IPv6
• Customizable tracing options:
  • packet size & payload pattern
  • start and maximum time-to-live (TTL)
  • minimum and maximum round duration
  • round end grace period & maximum number of unknown hops
  • source & destination port (TCP & UDP)
  • source address and source interface
  • TOS (aka DSCP + ECN)
• Support for classic, paris and dublin Equal Cost Multi-path Routing strategies (tracking issue)
• RFC4884 ICMP Multi-Part Messages
  • Generic Extension Objects
  • MPLS Label Stacks
• Unprivileged mode
• NAT detection
• Tui interface:
  • Trace multiple targets simultaneously from a single instance of Trippy
  • Per hop stats (sent, received, loss%, last, avg, best, worst, stddev, jitter & status)
  • Per hop round-trip-time (RTT) history and frequency distributing charts
  • Interactive chart of RTT for all hops in a trace with zooming capability
  • Interactive GeoIp world map
  • Isolate and filter by individual tracing flows
  • Customizable color theme & key bindings
  • Customizable column order and visibility
  • Configuration via both command line arguments and a configuration file
  • Show multiple hosts per hop with ability to cap display to N hosts and show frequency %
  • Show hop details and navigate hosts within each hop
  • Freeze/unfreeze the Tui, reset the stats, flush the cache, preserve screen on exit
  • Responsive UI with adjustable refresh rate
  • Hop privacy
• DNS:
  • Use system, external (Google 8.8.8.8 or Cloudflare 1.1.1.1) or custom resolver
  • Lazy reverse DNS queries
  • Lookup autonomous system number (ASN) and name
• GeoIp:
  • Lookup and display GeoIp information from local MaxMind and IPinfo mmdb files
• Generate tracing reports:
  • json, csv & tabular (pretty-printed and markdown)
  • Tracing flows report
  • Graphviz dot charts
  • configurable reporting cycles
• Runs on multiple platform (macOS, Linux, Windows, NetBSD, FreeBSD, OpenBSD)
• Capabilities aware application (Linux only)

Versions

The following table lists ths versions of Trippy that are available and links to the corresponding release note and documentation:

Version	Release Date	Status	Release Note	Documentation
0.12.0-dev	n/a	Development	n/a	docs
0.11.0	2024-08-11	Current	note	docs
0.10.0	2024-03-31	Previous	note	docs
0.9.0	2023-11-30	Deprecated	note	docs
0.8.0	2023-05-15	Deprecated	note	docs
0.7.0	2023-03-25	Deprecated	note	docs
0.6.0	2022-08-19	Deprecated	note	docs

[!NOTE] Only the latest patch versions of both the current and previous releases of Trippy are supported.

Distributions

Cargo

cargo install trippy --locked

PPA (Ubuntu)

sudo add-apt-repository ppa:fujiapple/trippy
sudo apt update && apt install trippy

Snap (Linux)

snap install trippy

Homebrew (macOS)

brew install trippy

WinGet (Windows)

winget install trippy

Scoop (Windows)

scoop install trippy

Chocolatey (Windows)

choco install trippy

NetBSD

pkgin install trippy

FreeBSD

pkg install trippy

OpenBSD

pkg_add trippy

Pacman (Arch Linux)

pacman -S trippy

Nix

nix-env -iA trippy

Docker

docker run -it fujiapple/trippy

Binary Asset Download

OS	Arch	Env	Current	Previous
Linux	x86_64	gnu	0.11.0	0.10.0
Linux	x86_64	musl	0.11.0	0.10.0
Linux	aarch64	gnu	0.11.0	0.10.0
Linux	aarch64	musl	0.11.0	0.10.0
Linux	arm7	gnueabihf	0.11.0	0.10.0
Linux	arm7	musleabi	0.11.0	0.10.0
Linux	arm7	musleabihf	0.11.0	0.10.0
macOS	x86_64	darwin	0.11.0	0.10.0
macOS	aarch64	darwin	0.11.0	0.10.0
Windows	x86_64	msvc	0.11.0	0.10.0
Windows	x86_64	gnu	0.11.0	0.10.0
Windows	aarch64	msvc	0.11.0	0.10.0
FreeBSD	x86_64	n/a	0.11.0	0.10.0
NetBSD	x86_64	n/a	0.11.0