From 2922bbdd6ab8d91064b8531e9d87c329b0dde40d Mon Sep 17 00:00:00 2001
From: jbranchaud <jbranchaud@gmail.com>
Date: Tue, 24 Sep 2024 11:08:38 -0500
Subject: [PATCH] Add Check Network Quality Stats From The Command Line as a
 Mac TIL

---
 README.md                                     |  3 +-
 ...ork-quality-stats-from-the-command-line.md | 44 +++++++++++++++++++
 2 files changed, 46 insertions(+), 1 deletion(-)
 create mode 100644 mac/check-network-quality-stats-from-the-command-line.md

diff --git a/README.md b/README.md
index b16a220..8f365ac 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@ pairing with smart people at Hashrocket.
 
 For a steady stream of TILs, [sign up for my newsletter](https://crafty-builder-6996.ck.page/e169c61186).
 
-_1442 TILs and counting..._
+_1443 TILs and counting..._
 
 ---
 
@@ -571,6 +571,7 @@ _1442 TILs and counting..._
 - [Access All Screen And Video Capture Options](mac/access-all-screen-and-video-capture-options.md)
 - [Access System Information On OS X](mac/access-system-information-on-osx.md)
 - [Access Unsupported Screen Resolutions With RDM](mac/access-unsupported-screen-resolutions-with-rdm.md)
+- [Check Network Quality Stats From The Command Line](mac/check-network-quality-stats-from-the-command-line.md)
 - [Clean Up Old Homebrew Files](mac/clean-up-old-homebrew-files.md)
 - [Convert An HEIC Image File To JPG](mac/convert-an-heic-image-file-to-jpg.md)
 - [Default Screenshot Location](mac/default-screenshot-location.md)
diff --git a/mac/check-network-quality-stats-from-the-command-line.md b/mac/check-network-quality-stats-from-the-command-line.md
new file mode 100644
index 0000000..3df1068
--- /dev/null
+++ b/mac/check-network-quality-stats-from-the-command-line.md
@@ -0,0 +1,44 @@
+# Check Network Quality Stats From The Command Line
+
+MacOS comes with a little known CLI utility for checking your current network
+quality statistics. It is aptly named `networkQuality`.
+
+Here is what a basic run of the tool might output:
+
+```bash
+$ networkQuality
+
+...
+Downlink: capacity 281.430 Mbps, responsiveness 101 RPM - Uplink: capacity 16.629 Mbps, responsiveness 101 R
+Downlink: capacity 285.534 Mbps, responsiveness 101 RPM - Uplink: capacity 16.028 Mbps, responsiveness 101 R
+==== SUMMARY ====
+Uplink capacity: 22.982 Mbps
+Downlink capacity: 288.152 Mbps
+Responsiveness: Low (93 RPM)
+Idle Latency: 26.375 milliseconds
+```
+
+You can get an even more detailed summary with the `-v` option:
+
+```bash
+$ networkQuality -v
+
+...
+==== SUMMARY ====
+Uplink capacity: 18.257 Mbps (Accuracy: High)
+Downlink capacity: 469.355 Mbps (Accuracy: High)
+Responsiveness: Medium (252 RPM) (Accuracy: High)
+Idle Latency: 25.583 milliseconds (Accuracy: High)
+Interface: en0
+Uplink bytes transferred: 19.750 MB
+Downlink bytes transferred: 488.265 MB
+Uplink Flow count: 8
+Downlink Flow count: 12
+Start: 9/24/24, 11:06:20 AM
+End: 9/24/24, 11:06:30 AM
+OS Version: Version 13.5.2 (Build 22G91)
+```
+
+See `man networkQuality` for more details.
+
+[source](https://cyberhost.uk/the-hidden-macos-speedtest-tool-networkquality/)