What System Metrics Are Collected by Vorssaint-Utils: Technical Breakdown

Vorssaint-Utils collects eight categories of real‑time system metrics—including CPU, GPU, memory, temperature, battery, network, and fan data—using native macOS APIs with zero off‑device telemetry.

Vorssaint-Utils is a macOS system utility that powers its System Monitor through comprehensive local data collection. The vorssaint/vorssaint-utils repository implements the system metrics collected by Vorssaint-Utils via Swift modules that interface directly with IOKit, HostStatistics, and ProcessInfo on Apple Silicon devices running macOS 14+. All processing remains on‑device to ensure user privacy while providing real‑time visualization.

Hardware Performance Metrics

The core hardware monitoring capabilities track processor utilization and thermal states through dedicated provider classes in the VorssaintCore module.

CPU and GPU Utilization

In Sources/VorssaintCore/SystemInfo.swift, the SystemInfo class aggregates real‑time processor metrics. The implementation exposes current CPU usage as a percentage value and captures GPU utilization when hardware sensors are available.

Access these metrics through the shared instance:

import VorssaintCore

let cpuUsage = SystemInfo.shared.cpuUsage          // Float (0‑100 %)
let memoryInfo = SystemInfo.shared.memoryInfo      // (used: UInt64, total: UInt64)

print("CPU \(cpuUsage)% – Memory \(memoryInfo.used)/\(memoryInfo.total) bytes")

Thermal Monitoring

The same SystemInfo provider reads CPU temperature, GPU temperature (where exposed by the hardware), and other system sensor values through IOKit interfaces. These readings enable the System Monitor to display thermal throttling risks before performance degradation occurs.

Power and Battery Analytics

Battery metrics are isolated in a dedicated provider to handle the complexity of modern power management circuits.

Battery Health and Cycle Tracking

Sources/VorssaintCore/BatteryInfo.swift implements the BatteryInfo class, which queries charge level, health status, time remaining, cycle count, power draw, and temperature. These metrics expose long‑term battery degradation patterns alongside real‑time power consumption.

Retrieve battery statistics using:

let battery = BatteryInfo.shared
print("Charge:", battery.chargePercent, "%")
print("Health:", battery.healthStatus)
print("Temperature:", battery.temperatureCelsius, "°C")

Memory and Process Management

Vorssaint-Utils distinguishes between system‑wide memory pressure and per‑application consumption patterns.

System Memory Tracking

The SystemInfo.shared.memoryInfo interface returns total memory in use, swap utilization, and memory pressure levels through HostStatistics API calls. This data identifies physical RAM saturation before the system invokes aggressive swap compression.

Process Energy Consumption

The utility maintains a live list of applications currently consuming significant energy, sourced from ProcessInfo queries. Users can trigger shortcuts to macOS’s full process inspector directly from this list to terminate runaway processes.

Network Performance Monitoring

Sources/VorssaintCore/NetworkMonitor.swift implements the NetworkMonitor class to track live upload and download rates, session totals, and built‑in speed test capabilities. The implementation uses network interface counters to calculate throughput without requiring elevated privileges.

Monitor network activity programmatically:

let net = NetworkMonitor.shared
print("Down:", net.currentDownloadRate, "KB/s")
print("Up:",   net.currentUploadRate,   "KB/s")

Fan Control and Custom Curves (Beta)

Sources/VorssaintCore/FanControl.swift provides optional manual control over cooling systems on supported hardware. The implementation reads current fan speeds in RPM and allows custom temperature curves or manual speed overrides when the beta feature is enabled.

Alert System and Thresholds

Sources/VorssaintCore/Alerts.swift implements proactive monitoring that triggers user‑visible notifications based on configurable thresholds:

• CPU load spikes exceeding sustained utilization limits
• High temperature warnings for CPU or battery components
• Memory pressure warnings indicating imminent swap thrashing
• Low disk space warnings for system volume capacity
• Low battery warnings at user‑defined charge percentages

These alerts are generated locally without network dependencies, ensuring immediate notification even in offline environments.

Core Implementation Files

According to the vorssaint/vorssaint-utils source code, the metric collection architecture is partitioned across five primary files:

• Sources/VorssaintCore/SystemInfo.swift – Central provider aggregating CPU, GPU, memory, and temperature data from IOKit and HostStatistics.
• Sources/VorssaintCore/BatteryInfo.swift – Battery‑specific queries including charge cycles, health algorithms, and thermal readings.
• Sources/VorssaintCore/NetworkMonitor.swift – Real‑time traffic accounting and speed test orchestration.
• Sources/VorssaintCore/FanControl.swift – Hardware fan RPM monitoring and manual control interfaces (beta).
• Sources/VorssaintCore/Alerts.swift – Threshold evaluation engine generating user notifications.

Summary

• Vorssaint-Utils collects eight distinct metric categories: CPU/GPU utilization, memory pressure, thermal sensors, battery health, network throughput, fan speeds, process energy, and alert conditions.
• All data is sourced via native macOS APIs (IOKit, HostStatistics, ProcessInfo) on macOS 14+ Apple Silicon systems.
• The implementation uses five core Swift files in the VorssaintCore module to aggregate and expose system state.
• Zero telemetry is transmitted off‑device; metrics remain local for on‑screen visualization and user‑triggered actions.
• Programmatic access is available through shared singleton interfaces like SystemInfo.shared, BatteryInfo.shared, and NetworkMonitor.shared.

Frequently Asked Questions

Does Vorssaint-Utils send system metrics to external servers?

No. According to the vorssaint/vorssaint-utils source code, all system metrics collected by Vorssaint-Utils are processed locally using native macOS APIs. The architecture explicitly avoids network transmission to preserve user privacy, functioning entirely on‑device for visualization and alerting purposes.

Which macOS versions support all metric categories?

The complete metric suite requires macOS 14 or later running on Apple Silicon hardware. Earlier versions or Intel‑based Macs may lack access to specific GPU temperature sensors, battery health details, or fan control capabilities exposed through modern IOKit interfaces.

How does the fan control feature work?

The optional beta feature implemented in Sources/VorssaintCore/FanControl.swift reads current RPM values from hardware tachometers and allows manual speed overrides or custom temperature curves. This requires direct IOKit communication with the System Management Controller (SMC) on supported devices.

Can developers access these metrics programmatically?

Yes. The repository exposes public Swift interfaces through the VorssaintCore module, providing singleton instances like SystemInfo.shared and BatteryInfo.shared with properties for usage percentages, memory statistics, and thermal readings suitable for integration into third‑party macOS applications.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}