xping 1.0.3

Beautiful CLI network diagnostics — ping, traceroute, and DNS lookup

xping

Beautiful CLI network diagnostics — ping, traceroute, and DNS lookup.

Zero external Python dependencies. Pure stdlib. Linux & macOS.

  ██╗  ██╗██████╗ ██╗███╗   ██╗ ██████╗
  ╚██╗██╔╝██╔══██╗██║████╗  ██║██╔════╝
   ╚███╔╝ ██████╔╝██║██╔██╗ ██║██║  ███╗
   ██╔██╗ ██╔═══╝ ██║██║╚██╗██║██║   ██║
  ██╔╝ ██╗██║     ██║██║ ╚████║╚██████╔╝
  ╚═╝  ╚═╝╚═╝     ╚═╝╚═╝  ╚═══╝ ╚═════╝
  network diagnostics  ·  beautiful by default

Created by Meh Askari — see LICENSE for attribution terms.

---

Features

• Ping — Live per-packet latency bars, animated spinner, sparkline chart, full statistics
• Traceroute — Real-time hop-by-hop path with RTT colour coding and summary
• DNS Lookup — A, AAAA, MX, NS, TXT (SPF / DMARC / DKIM) with reverse DNS
• All-in-one — Run all three in a single command
• Dependency checker — xping deps detects missing tools and shows the correct install command for your distro
• Zero Python deps — stdlib only (Python ≥ 3.10)
• True-colour output — ANSI 24-bit colour, animated spinners, live sparklines
• man page included — man xping works after installation

---

Installation

Ubuntu / Debian / Linux Mint / Pop!_OS — PPA (recommended)

sudo add-apt-repository ppa:mehdiaskari/xping
sudo apt update
sudo apt install python3-xping

Supported: Ubuntu 22.04 LTS, 24.04 LTS, Linux Mint 21+, Pop!_OS 22.04+

PyPI (all platforms)

pipx install xping

From source

git clone https://github.com/mehaskari/xping
cd xping
pip install .

Arch Linux (AUR)

yay -S python-xping

Manual page (source installs)

sudo cp man/xping.1 /usr/share/man/man1/
sudo gzip /usr/share/man/man1/xping.1
sudo mandb
man xping

---

Usage

xping <command> <host> [options]

Ping

xping ping google.com
xping ping 1.1.1.1 -c 10          # 10 packets
xping ping example.com -i 0.2     # 200 ms interval
xping ping host.local -t 5        # 5 s timeout

Traceroute

xping trace google.com
xping trace 8.8.8.8 --max-hops 15
xping trace example.com --probes 5

DNS Lookup

xping lookup github.com
xping lookup github.com --full    # includes TXT / SPF / DMARC / DKIM

All at once

xping all cloudflare.com

Dependency check

xping deps

---

Permissions

ICMP raw sockets require root or cap_net_raw. Without them xping automatically falls back to the system ping / traceroute binaries.

Grant capability without running as root:

sudo setcap cap_net_raw+ep $(which xping)

---

Environment variables

Variable	Effect
NO_COLOR	Disable all ANSI colour output
XPING_DEBUG	Print full Python tracebacks on errors

---

Contributing

1. Fork and clone the repository
2. pip install -e .
3. Make your changes
4. Run python -m pytest tests/
5. Open a pull request

---

License

MIT with Mandatory Attribution — see LICENSE.

Any fork, derivative work, or redistribution must visibly credit Meh Askari <[e-mail]>.