gping 🚀
Ping, but with a graph.
Comes with the following super-powers:
* Graph the ping time for multiple hosts
* Graph the execution time for commands via the --cmd flag
* Custom colours
* Windows, Mac and Linux support
Table of Contents
Install :cd:
- macOS
- Linux (Homebrew):
brew install gping
- CentOS (and other distributions with an old glibc): Download the MUSL build from the latest release
- Windows/ARM:
- Fedora (COPR):
sudo dnf copr enable atim/gping -y && sudo dnf install gping
- Cargo (This requires
rustc version 1.44.0 or greater): cargo install gping
- Arch Linux:
pacman -S gping
- Ubuntu/Debian (Azlux's repo):
bash
echo "deb http://packages.azlux.fr/debian/ buster main" | sudo tee /etc/apt/sources.list.d/azlux.list
wget -qO - https://azlux.fr/repo.gpg.key | sudo apt-key add -
sudo apt update
sudo apt install gping
- Gentoo (dm9pZCAq overlay):
sh
sudo eselect repository enable dm9pZCAq
sudo emerge --sync dm9pZCAq
sudo emerge net-misc/gping::dm9pZCAq
- FreeBSD:
- pkg:
pkg install gping
- ports
cd /usr/ports/net-mgmt/gping; make install clean
Usage :saxophone:
Just run gping [host]. host can be a command like curl google.com if the --cmd flag is used. You can also use
shorthands like aws:eu-west-1 or aws:ca-central-1 to ping specific cloud regions. Only aws is currently supported.
```bash
$ gping --help
Ping, but with a graph.
Usage: gping [OPTIONS] [HOSTSORCOMMANDS]...
Arguments:
[HOSTSORCOMMANDS]... Hosts or IPs to ping, or commands to run if --cmd is provided. Can use cloud shorthands like aws:eu-west-1.
Options:
--cmd
Graph the execution time for a list of commands rather than pinging hosts
-n, --watch-interval
Watch interval seconds (provide partial seconds like '0.5'). Default for ping is 0.2, default for cmd is 0.5.
-b, --buffer
Determines the number of seconds to display in the graph. [default: 30]
-4
Resolve ping targets to IPv4 address
-6
Resolve ping targets to IPv6 address
-i, --interface
Interface to use when pinging
-s, --simple-graphics
Uses dot characters instead of braille
--vertical-margin
Vertical margin around the graph (top and bottom) [default: 1]
--horizontal-margin
Horizontal margin around the graph (left and right) [default: 0]
-c, --color
Assign color to a graph entry. This option can be defined more than once as a comma separated string, and the order which the colors are provided will be matched against the hosts or commands passed to gping. Hexadecimal RGB color codes are accepted in the form of '#RRGGBB' or the following color names: 'black', 'red', 'green', 'yellow', 'blue', 'magenta','cyan', 'gray', 'dark-gray', 'light-red', 'light-green', 'light-yellow', 'light-blue', 'light-magenta', 'light-cyan', and 'white'
-h, --help
Print help information
-V, --version
Print version information
--clear
Clear the graph from the terminal after closing the program
```