How to Test Your Internet Speed on Mac Using the networkQuality Tool

The Problems with Web-Based Speed Test Services

When internet connectivity slows down, video calls stutter, or large cloud backups stall, our first instinct is to open a browser and visit a public internet speed test website. While web-based tools provide a general gauge of raw throughput, they come with substantial drawbacks: they are heavily laden with tracking scripts and flashing advertisements, require loading complex JavaScript rendering engines that distort measurement accuracy, and usually test single-stream transfers sequentially rather than simultaneous real-world conditions.

Crucially, most consumer web speed tests ignore bufferbloat (latency under load)—the true culprit behind lagging Zoom calls and gaming disconnects when someone else on your network starts downloading a file. To provide network engineers and Mac users with enterprise-grade internet diagnostics, Apple integrated a dedicated, command-line diagnostic tool directly into macOS: networkQuality. Completely free of third-party ads and trackers, it tests true simultaneous bidirectional bandwidth and responsiveness in seconds.

What Is networkQuality and How Does It Work?

Introduced in macOS Monterey and standard across all macOS releases (including macOS Sonoma and Sequoia), networkQuality measures your internet connection according to Apple’s standardized Responsiveness metrics (measured in RPM: Roundtrips Per Minute):

• Bidirectional Concurrency: Unlike traditional tests that test downloads first and uploads second, networkQuality pumps simultaneous bidirectional TCP and UDP traffic through Apple’s high-speed global Content Delivery Network (CDN) servers, mimicking real-world heavy usage.
• Bufferbloat Diagnosis (RPM): Measures how many complete network roundtrips your connection can successfully complete each minute while under full upload and download saturation. A high RPM means video calls and gaming stay silky smooth even during massive file downloads.

Step-by-Step Tutorial: Running networkQuality in Terminal

You do not need to install Homebrew packages or third-party software. The utility is built into every Mac:

1. Open Terminal on your Mac (press Command + Space, type Terminal, and press Enter).
2. Type the standard command and press Enter:

   networkQuality

3. Terminal will execute simultaneous upload and download streams against Apple’s nearest edge servers. The test takes approximately 10 to 15 seconds.

Interpreting the Standard Output

When the test concludes, Terminal prints a concise three-line summary:

==== SUMMARY ====
Uplink capacity: 94.212 Mbps
Downlink capacity: 482.510 Mbps
Responsiveness: High (2480 RPM)

Understanding Responsiveness (RPM Ratings)

Apple categorises your network’s responsiveness into three clear tiers:

Rating	RPM Score	What It Means in Real Life
Low	< 600 RPM	Severe bufferbloat. If another device or app on your Wi-Fi downloads a file, video calls will freeze, voice audio will distort, and gaming will lag.
Medium	600 – 1,200 RPM	Moderate stability. Video streams remain stable, but gaming or VoIP calls may experience brief audio glitches under sudden network spikes.
High	> 1,200 RPM	Excellent bufferbloat control. Multiple devices can stream 4K video, download files, and attend conferences simultaneously without perceptible latency.

Advanced Flags for In-Depth Network Diagnostics

1. Sequential Testing (Testing Pure Maximum Throughput)

If you want to measure the maximum theoretical throughput of your broadband pipe without simultaneous upload/download collisions, pass the -s flag:

networkQuality -s

2. Verbose Diagnostic Output (-v)

To inspect raw packet latency, minimum/maximum roundtrip times (RTT), and TLS handshake speeds:

networkQuality -v

3. Exporting Clean JSON Output (-c)

If you are writing a shell script or monitoring Wi-Fi performance over time, output data in structured JSON:

networkQuality -c

Troubleshooting Low Responsiveness Scores

If your Mac reports high download speeds but a Low responsiveness score:

• Switch to a 5GHz or 6GHz Wi-Fi Band: Crowded 2.4GHz bands suffer from heavy packet collisions, which degrades RPM scores dramatically.
• Enable Smart Queue Management (SQM): Modern routers include SQM or CAKE queue management. Turning SQM on in your router dashboard completely eliminates bufferbloat by prioritising interactive VoIP and DNS packets over bulk file downloads.
• Test via Ethernet: If possible, connect your Mac with a USB-C Ethernet adapter to isolate whether latency is caused by wireless interference or your actual broadband modem.

Frequently Asked Questions

Can I choose a different test server with networkQuality?

By default, the tool connects to Apple’s CDN edge infrastructure. Advanced users can specify custom test configuration URLs using the -C flag.

Does networkQuality consume a lot of internet data?

Because the test saturates your connection for 10 seconds to measure real-world performance, a single test on a gigabit connection can consume between 500 MB and 1.5 GB of data. Avoid running repeated tests when connected to metered mobile hotspots.