back to home

fujiapple852 / trippy

A network diagnostic tool

6,630 stars
209 forks
74 issues
RustShellDockerfile
Chat with CodebaseArchitecture ScanSecurity AuditExplain Codebase

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing fujiapple852/trippy in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Click here to launch the interactive analysis workspace

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind-ai.vercel.app/repo/fujiapple852/trippy)
Preview:Analyzed by RepoMind

Repository Summary (README)

Preview
<p align="center"> <img src="https://raw.githubusercontent.com/fujiapple852/trippy/master/docs/src/assets/Trippy-Vertical-DarkMode.svg#gh-dark-mode-only" width="300"> <img src="https://raw.githubusercontent.com/fujiapple852/trippy/master/docs/src/assets/Trippy-Vertical.svg#gh-light-mode-only" width="300"><br> <br> <a href="https://github.com/fujiapple852/trippy/actions/workflows/ci.yml"> <img src="https://github.com/fujiapple852/trippy/actions/workflows/ci.yml/badge.svg?branch=master"></a> <a href="https://crates.io/crates/trippy/0.13.0"> <img src="https://img.shields.io/crates/v/trippy.svg"></a> <a href="https://repology.org/project/trippy/versions"> <img src="https://repology.org/badge/tiny-repos/trippy.svg"></a> <a href="https://trippy.zulipchat.com"> <img src="https://img.shields.io/badge/zulip-join_chat-brightgreen.svg"></a> <a href="https://matrix.to/#/#trippy-dev:matrix.org"> <img src="https://img.shields.io/badge/matrix/trippy-dev:matrix.org-blue"></a> <br> <br> Trippy combines the functionality of traceroute and ping and is designed to assist with the analysis of networking issues. </p> <img src="https://raw.githubusercontent.com/fujiapple852/trippy/master/assets/0.12.0/demo.gif" alt="trippy"/>

Quick Start

See the getting started guide.

Install

Trippy runs on Linux, BSD, macOS, and Windows. It can be installed from most package managers, precompiled binaries, or source.

For example, to install Trippy from cargo:

cargo install trippy --locked
<details> <summary>All package managers</summary>

Cargo

Crates.io

cargo install trippy --locked

APT (Debian)

Debian 13 package

apt install trippy

ⓘ Note:

Only available for Debian 13 (trixie) and later.

PPA (Ubuntu)

Ubuntu PPA

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

ⓘ Note:

Only available for Ubuntu 24.04 (Noble) and 22.04 (Jammy).

Snap (Linux)

trippy

snap install trippy

Homebrew (macOS)

Homebrew package

brew install trippy

WinGet (Windows)

winget package

winget install trippy

Scoop (Windows)

Scoop package

scoop install trippy

Chocolatey (Windows)

Chocolatey package

choco install trippy

NetBSD

pkgsrc current package

pkgin install trippy

FreeBSD

FreeBSD port

pkg install trippy

OpenBSD

OpenBSD port

pkg_add trippy

Arch Linux

Arch package

pacman -S trippy

Gentoo Linux

Gentoo package

emerge -av net-analyzer/trippy

Void Linux

Void Linux x86_64 package

xbps-install -S trippy

ALT Sisyphus

ALT Sisyphus package

apt-get install trippy

Chimera Linux

Chimera Linux package

apk add trippy

Nix

nixpkgs unstable package

nix-env -iA trippy

Docker

Docker Image Version (latest by date)

docker run -it fujiapple/trippy

All Repositories

Packaging status

</details>

See the installation guide for details of how to install Trippy on your system.

Run

To run a basic trace to example.com with default settings, use the following command:

sudo trip example.com

See the usage examples and CLI reference for details of how to use Trippy. To use Trippy without elevated privileges, see the privileges guide.

Documentation

Full documentation is available at trippy.rs.

<details> <summary>documentation links</summary>

Getting Started

See the Getting Started guide.

Features

See the Features list.

Distributions

See the Distributions list.

Privileges

See the Privileges guide.

Usage Examples

See the Usage Examples.

Command Reference

See the Command Reference.

Theme Reference

See the Theme Reference.

Column Reference

See the Column Reference.

Configuration Reference

See the Configuration Reference.

Locale Reference

See the Locale Reference.

Versions

See the Version Reference.

Frequently Asked Questions

Why does Trippy show "Awaiting data..."?

See the Awaiting Data guide.

<a name="windows-defender"></a>

How do I allow incoming ICMP traffic in the Windows Defender firewall?

See the Windows Defender Firewall guide.

What are the recommended settings for Trippy?

See the Recommended Tracing Settings guide.

</details>

Acknowledgements

Trippy is made possible by ratatui ( formerly tui-rs), crossterm as well as several foundational Rust libraries.

Trippy draws heavily from mtr and also incorporates ideas from both libparistraceroute & Dublin Traceroute.

The Trippy networking code is inspired by pnet and some elements of that codebase are incorporated in Trippy.

The AS data is retrieved from the IP to ASN Mapping Service provided by Team Cymru.

The trippy.cli.rs CNAME hosting is provided by cli.rs.

The Trippy chat room is sponsored by Zulip.

Trippy logo designed by Harun Ocaksiz Design.

License

This project is distributed under the terms of the Apache License (Version 2.0).

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in time by you, as defined in the Apache-2.0 license, shall be licensed as above, without any additional terms or conditions.

See LICENSE for details.

Copyright 2022 Trippy Contributors