# Vorssaint-Utils Dependencies: System Requirements and Build Guide

> Discover vorssaint-utils dependencies. Learn system requirements and build guide for this macOS library, requiring only HIDEventSystem and VMStatisticsCompat.

- Repository: [vorssaint/vorssaint-utils](https://github.com/vorssaint/vorssaint-utils)
- Tags: how-to-guide
- Published: 2026-09-13

---

**Vorssaint-Utils requires zero external Swift packages and depends only on two macOS system libraries—HIDEventSystem and VMStatisticsCompat—to build the executable target.**

Vorssaint-Utils is a pure-Swift macOS utility designed to operate without third-party dependencies. As implemented in `vorssaint/vorssaint-utils`, the project deliberately avoids external Swift Package Manager (SPM) libraries, relying exclusively on low-level system wrappers that interface directly with native macOS APIs.

## No External Swift Package Dependencies

The repository contains no `Package.resolved` file, confirming that no external dependencies are pinned or locked. According to the source analysis of [`Package.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Package.swift), the manifest declares no URL-based package dependencies, eliminating risks associated with supply chain attacks or version conflicts common in projects using Alamofire, SwiftUI-Extensions, or other popular packages.

## Required macOS System Libraries

The build process requires only two system libraries that ship with the repository itself:

### HIDEventSystem for Input Handling

**HIDEventSystem** provides thin wrappers around the macOS HID (Human Interface Device) event subsystem. Defined in `Sources/HIDEventSystem/module.modulemap`, this library enables the app to register global keyboard and mouse gesture listeners outside the standard responder chain.

### VMStatisticsCompat for System Monitoring

**VMStatisticsCompat** supplies a compatibility layer for macOS VM statistics APIs. Located in `Sources/VMStatisticsCompat/module.modulemap`, this library bridges kernel-level memory statistics to Swift, powering the built-in system-monitor panels with data about free and active memory pages.

## Build Configuration in Package.swift

Lines 11-18 of [`Package.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Package.swift) declare the executable target and its local system library dependencies:

```swift
.executableTarget(
    name: "Vorssaint",
    dependencies: ["VMStatisticsCompat", "HIDEventSystem"],
    path: "Sources/Vorssaint"
)

```

This configuration links the `Vorssaint` executable against both system libraries without pulling in any remote packages.

## Usage in Source Files

The dependencies are utilized throughout the codebase to handle global shortcuts and system monitoring.

### Global Gesture Handling

In [`Sources/Vorssaint/UI/WindowGestureControls.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/Vorssaint/UI/WindowGestureControls.swift), the HIDEventSystem registers application-wide hotkeys:

```swift
import HIDEventSystem

let hotKey = HIDEventSystem.registerShortcut(
    keyCode: kVK_ANSI_S,
    modifiers: [.command, .option],
    action: { print("Super-Key triggered!") }
)

```

### Memory Statistics Queries

The [`Sources/Vorssaint/UI/Settings/WindowLayoutSettings.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/Vorssaint/UI/Settings/WindowLayoutSettings.swift) file queries VM statistics to adjust UI elements dynamically:

```swift
import VMStatisticsCompat

if let stats = VMStatisticsCompat.current() {
    print("Free memory: \(stats.freeBytes) bytes")
    print("Active memory: \(stats.activeBytes) bytes")
}

```

The entry point at [`Sources/Vorssaint/main.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/Vorssaint/main.swift) orchestrates these components, initializing the HID event listeners and system monitor panels on launch.

## Summary

- **Zero external dependencies**: No third-party Swift packages or `Package.resolved` file exists in the repository.
- **Two system libraries required**: HIDEventSystem and VMStatisticsCompat provide native API access.
- **Pure Swift build**: The project compiles on macOS 14+ using only the Swift toolchain and system frameworks.
- **Deterministic builds**: Local system libraries in `Sources/` ensure consistent compilation across environments.

## Frequently Asked Questions

### Does vorssaint-utils require CocoaPods or Carthage?

No. The project uses Swift Package Manager exclusively and contains no Podfile or Cartfile. You can clone the repository and run `swift build` immediately without installing additional dependency managers, as all required code resides in the local `Sources/` directory.

### What macOS version is needed to build vorssaint-utils?

The utility targets macOS 14 and later. This requirement stems from the VM statistics APIs wrapped by VMStatisticsCompat and the Swift toolchain features used in [`Sources/Vorssaint/main.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/Vorssaint/main.swift). Ensure your build machine runs macOS 14+ with Xcode 15 or a compatible Swift toolchain.

### Why does vorssaint-utils avoid third-party packages?

The maintainers chose a zero-dependency architecture to minimize binary size, eliminate supply chain vulnerabilities, and ensure the utility remains lightweight. By wrapping only the specific macOS HID and VM statistics APIs needed, the project maintains full control over implementation details without importing unused functionality from larger libraries.

### How can I verify the dependency list myself?

Examine [`Package.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Package.swift) at lines 11-18 to confirm only `"VMStatisticsCompat"` and `"HIDEventSystem"` appear in the dependencies array. Additionally, check for the absence of a `Package.resolved` file in the repository root, which would indicate locked external versions if third-party packages were present.