OFFICIAL DOCUMENTATION

User & Operations Guide

Detailed technical guide to measurement methodology, kernel counters, menu-bar display configurations, and operational scope.

1. Measurement Methodology

ARRY Network Counter calculates real-time network throughput by querying standard macOS kernel network statistics via the operating system's BSD getifaddrs interface.

Cumulative Kernel Byte Counters: ANC samples the cumulative received (ifi_ibytes) and transmitted (ifi_obytes) bytes for the primary active network interface.
Monotonic Timing: Time deltas are calculated using macOS monotonic system clocks (clock_gettime_nsec_np) sampled at steady 1-second intervals.
Single-Interface Policy: Traffic is monitored on the active default route adapter (e.g. Wi-Fi en0 or Ethernet en1). Virtual bridges and loopback adapters are not summed together.

2. Scope & Limitations: What ANC Is Not

To maintain absolute transparency with our users, please review the following operational boundaries:

  • Not an Internet Speed Test: ANC measures actual data moving across your network interface. It does not ping speed-test servers, execute synthetic download tests, or consume your internet bandwidth.
  • Local Network Traffic Included: Because kernel interface counters measure all link-level data traversing the hardware interface, local transfers (AirDrop, local NAS file copies, Time Machine network backups, printer data) and external internet traffic both contribute to throughput.
  • Not a Quota/Billing Tracker: ANC does not store historical traffic logs or track monthly ISP data caps. All throughput metrics exist only in volatile RAM for instantaneous display.

3. Configuring Settings

Click the ARRY Network Counter status item in your macOS menu bar and select Settings… (or press ⌘,) to open the native settings window:

Preferences Tab

Configure display modes, presentation styles, arrow visibility, and toggle Launch at Login.

Documentation Tab

Browse offline user guides, installation guides, terms, and privacy policy directly in-app.

About Tab

View build metadata, copyright disclosures, license terms, and platform compatibility.

4. Local-First Privacy Guarantees

ANC contains zero network sockets, zero HTTP clients, zero analytics trackers, and zero crash-reporting frameworks. It operates completely offline.

Persisted UserDefaults keys (4 values only):
• displayMode (string)
• bothDirectionsStyle (string)
• manualDirection (string)
• launchAtLogin (boolean)