Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

PingPlot Version 1.1.0

Author: Christopher Campo



PingPlot is a Python script which pings a given host and records the latency of each ping as a function of time. When you choose to stop, a plot is generated showing your latency to the host as a function of time since the startup of the program. It utilizes numerous Python libraries and especially takes advantage of Matplotlib and NumPy.

If you experience a timeout (100% packet loss) for a certain amount of time, the plot shows a red-shaded area across the times your connection to the host was down. This may be useful in diagnosing network connection issues, both client and server side.

PingPlot is meant to be run as a command line program. The run arguments/options are listed below. If you wish to run this program from Windows, create a shortcut, right click on it, scroll down to properties, and then append any of the options/arguments below to the target field. To run the program with these arguments, just run the shortcut.

If you have any questions/comments, please feel free to email me at or through my github page, Also feel free to create issues in this repo's issue tracker.

This application was inspired by PingPlotter, which is basically a more robust version of this software.

Example plot (the red bars indicate timeouts):

See the example directory for example log files.


This assumes you have Python (3+) installed on your system.

I recommend using a virtualenv:

$ python -m venv venv  

Then activate it:

$ source venv/bin/activate

Next, install the requirements:

$ pip install -r requirements.txt

Then run via the command line:

Usage: python [options]

-h, --help      show this help message and exit
-p, --plot      generates plot after data collection is finished
-f, --file      save plot to file in the current directory
-H HOST, --host=HOST the url or ip address to ping [default:]
-n N, --num=N     the number of packets to send on each ping iteration
          [default: 1]
-t DT, --dt=DT    the time interval (seconds) in which successive pings
          are sent [default: 0.5 s]
-l, --log       save a logfile of the event in the current directory
-s SIZE, --size=SIZE If plotting/saving a plot, this is the plot's
          dimensionsin pixels (at 80 DPI) in the format XxY
          [default: 1280x640]


$ python -H


Logs and plots latency to a host as a function of time. Useful for diagnosing network issues.




No releases published


No packages published

Contributors 4