networkQuality - macOS


networkQuality measures the quality of the active internet connection on a device running macOS. It utilizes various metrics to provide a comprehensive assessment of network performance and is useful for troubleshooting connectivity issues and monitoring network health.


networkQuality [-d] [-f <output format>] [-h] [-H <host>] [-i <interval>] [-n <duration>] [-v]


  • -d, –debug: Enable debug logging.
  • -f, –format : Output format (available options: json, pretty, verbose, csv). Default: “pretty”
  • -h, –help: Display help information.
  • -H, –host : Specify a hostname or IP address to measure performance to. Default: “”
  • -i, –interval : Interval between measurements in seconds. Default: 5
  • -n, –duration : Duration of the measurement in seconds. Default: 60
  • -v, –verbose: Display additional information.


  • Measure internet quality to a specific host:
    networkQuality -H

  • Measure internet quality and output in CSV format:
    networkQuality -f csv

  • Measure internet quality with 2-second intervals and 30-second duration:
    networkQuality -i 2 -n 30

Common Issues

  • Ensure your device has an active internet connection.
  • For host-specific measurements, the host must be reachable.
  • If measurements show consistently low quality, it may indicate a network or device issue.


networkQuality can be combined with other commands, such as ping and traceroute, to provide a more comprehensive network analysis. For example:

networkQuality -d | grep -i rtt
ping -c 5
  • ping
  • traceroute
  • netstat
  • ifconfig