When internet connections suffer from stuttering Zoom calls, gaming lag spikes, or delayed webpage rendering, users typically open a web browser to run a commercial speed test. However, traditional speed tests focus almost exclusively on maximum bandwidth—measuring peak download and upload numbers in Megabits per second (Mbps). In modern networking, high raw bandwidth does not guarantee a snappy user experience; network delays are frequently caused by bufferbloat, where network equipment buffers excess packets, introducing crippling latency under load. Starting with macOS Monterey and enhanced across Ventura, Sonoma, and Sequoia, Apple integrated a native, developer-grade benchmarking utility directly into the operating system: the networkQuality command in macOS Terminal.
Understanding Bufferbloat and Network Responsiveness
The networkQuality tool measures internet quality using modern IETF benchmarking standards:
- Responsiveness Under Load: While standard speed tests measure idle ping times before stressing your connection,
networkQualitymeasures latency while simultaneously saturating both your upload and download channels. - Round-Trips Per Minute (RPM): Apple introduces RPM as a standardized metric for network responsiveness. RPM measures how many sequential round-trip requests your network can complete in one minute under heavy simultaneous traffic.
- Native CDN Edge Saturation: The utility connects to Apple’s globally distributed content delivery network (CDN) endpoints using HTTP/2 and HTTP/3 multiplexing over TLS, eliminating browser overhead and third-party tracking scripts.
- Parallel Bidirectional Testing: Tests download and upload saturation concurrently, accurately replicating realistic household scenarios such as uploading video while participating in a 4K FaceTime call.
Step-by-Step: Running networkQuality in macOS Terminal
Because the utility is built natively into macOS, you do not need to install third-party packages or configure homebrew tools:
- Open Terminal on your Mac (press Command + Space, type
Terminal, and press Enter). - To run a standard baseline test, type:
networkQuality - Press Enter. The tool runs an automated 10 to 15-second diagnostic test.
- The terminal displays four key metrics upon completion:
- Uplink capacity: Upload bandwidth in Mbps.
- Downlink capacity: Download bandwidth in Mbps.
- Responsiveness: Network responsiveness rated as Low, Medium, or High, alongside your calculated RPM score.
- Idle Latency: Baseline round-trip time in milliseconds before network traffic was introduced.
Interpreting Your Round-Trips Per Minute (RPM) Score
Apple categorizes network responsiveness into three distinct quality tiers:
| Responsiveness Tier | RPM Range | User Experience Impact |
|---|---|---|
| Low Responsiveness | < 400 RPM | Noticeable bufferbloat. Video calls freeze and games lag whenever someone else uploads or downloads files on the local network. |
| Medium Responsiveness | 400 – 1,000 RPM | Acceptable household quality. Brief latency spikes occur during heavy concurrent file transfers. |
| High Responsiveness | > 1,000 RPM | Flawless low-latency performance. Real-time audio, 4K streaming, and cloud gaming remain smooth regardless of network load. |
Advanced networkQuality Command Flags
Power users and network engineers can pass specific flags to isolate Wi-Fi and routing issues:
1. Verbose Diagnostic Output (-v Flag)
To inspect raw metrics, TCP flow distributions, and detailed latency percentiles:
networkQuality -vThe verbose report reveals exact round-trip times (RTT) for base, download, and upload flows, as well as TLS handshake durations.
2. Sequential Testing (-s Flag)
By default, the tool saturates upload and download paths simultaneously. To test them sequentially (mirroring traditional speed test sites):
networkQuality -s3. Testing a Specific Network Interface (-I Flag)
If your Mac has multiple network adapters active (such as Wi-Fi and a Gigabit Ethernet dock), you can isolate testing to a specific interface:
networkQuality -I en0(Run ifconfig or networksetup -listallhardwareports to identify adapter names).
4. Exporting as Structured JSON (-c Flag)
For automated network monitoring scripts or logging over time:
networkQuality -cnetworkQuality vs Browser-Based Speed Tests
| Feature | macOS networkQuality | Browser Speed Tests (Ookla / Fast.com) |
|---|---|---|
| Bufferbloat Evaluation | Native (Calculates RPM under dual load) | Often measures idle latency only |
| Protocol Support | HTTP/2 and HTTP/3 via native Darwin sockets | Browser JavaScript WebSockets / Fetch API |
| Resource Footprint | Near-zero CPU overhead | Heavy browser DOM rendering & advertising scripts |
| Scriptability | Instant (JSON output via -c) |
Requires headless browser or unofficial CLI tools |
| Server Infrastructure | Apple global CDN edge servers | Third-party ISP sponsor servers |
How to Fix Low Responsiveness on Your Local Network
If your Mac scores a Low responsiveness rating (under 400 RPM):
- Enable Smart Queue Management (SQM): Modern Wi-Fi routers include SQM algorithms (such as CAKE or FQ-CoDel) designed specifically to eliminate bufferbloat by queuing packets fairly. Enable SQM in your router’s administration portal.
- Switch to 5GHz or 6GHz Wi-Fi: Legacy 2.4GHz Wi-Fi channels suffer from severe airwave congestion and interference from neighbouring routers, which degrades packet responsiveness.
- Use a Hardwired Ethernet Connection: Connecting your Mac directly to your router via Ethernet eliminates wireless airtime contention, routinely raising RPM scores above 1,500.
Frequently Asked Questions
Which versions of macOS support the networkQuality command?
The networkQuality binary was introduced in macOS 12 Monterey and is standard across all subsequent versions, including macOS 13 Ventura, macOS 14 Sonoma, and macOS 15 Sequoia.
Does running networkQuality consume significant mobile data?
Yes. Because the utility saturates your connection for 10–15 seconds to measure peak capacity, running it over a metered cellular iPhone hotspot can consume between 100 MB and 1.5 GB of data depending on your connection speed.
Can I test local network LAN speeds between two Macs with this tool?
By default, networkQuality tests internet routes to Apple edge servers. However, you can pass the -C <url> flag to target a local server running a compatible network responsiveness measurement server.