# How to Find the Latest Release of vorssaint-utils: GitHub API and Download Guide

> Find the latest vorssaint-utils release on GitHub. Access the newest version via GitHub Releases or query it programmatically using the GitHub API. Get the latest download now.

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

---

**The latest release of vorssaint-utils is hosted on GitHub Releases at `https://github.com/vorssaint/vorssaint-utils/releases/latest` and can be queried programmatically via the GitHub API endpoint.**

The vorssaint-utils repository distributes macOS applications through GitHub's release infrastructure. Understanding how to locate and download the most recent version requires knowing both the public release page URL and the internal mechanics used by the application's **UpdateService** to detect new versions automatically.

## Locating the Latest Release on GitHub

The canonical location for the newest version is the GitHub Releases page:

```text
https://github.com/vorssaint/vorssaint-utils/releases/latest

```

Visiting this URL triggers an automatic redirect to the most recent tagged release (for example, `v3.2.0`). The release assets include the macOS installer, typically packaged as a `.dmg` file following the naming pattern `vorssaint-<version>-showcase-1.dmg`.

To retrieve version metadata without browser interaction, query the GitHub REST API directly:

```text
https://api.github.com/repos/vorssaint/vorssaint-utils/releases/latest

```

This endpoint returns a JSON payload containing `tag_name`, `name`, and an `assets` array with download URLs.

## How UpdateService Queries the GitHub API

According to the source code in [`Sources/Vorssaint/Services/Update/UpdateService.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/Vorssaint/Services/Update/UpdateService.swift), the application determines available updates by constructing a dynamic request URL at line 123:

```swift
"https://api.github.com/repos/\(repository)/releases/latest"

```

When the **UpdateService** detects a newer version via this API call, it directs users to the GitHub releases page where they can download the installer asset manually. The companion file [`Sources/Vorssaint/Services/AppUpdates/AppUpdatesSupport.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/Vorssaint/Services/AppUpdates/AppUpdatesSupport.swift) handles subsequent version comparison logic and update user interface presentation.

## Programmatically Fetching the Latest Release

### Using Swift and URLSession

You can implement automatic version checking in Swift by parsing the GitHub API response:

```swift
import Foundation

let url = URL(string: "https://api.github.com/repos/vorssaint/vorssaint-utils/releases/latest")!
let task = URLSession.shared.dataTask(with: url) { data, _, error in
    guard let data = data, error == nil,
          let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
          let tag = json["tag_name"] as? String,
          let assets = json["assets"] as? [[String: Any]],
          let dmg = assets.first(where: { ($0["name"] as? String)?.hasSuffix(".dmg") == true })
    else { return }

    print("Latest version: \(tag)")
    print("Download URL: \(dmg["browser_download_url"] as? String ?? "N/A")")
}
task.resume()

```

### Using cURL and jq in Shell Scripts

For automation or CI/CD pipelines, fetch the `.dmg` directly using command-line tools:

```bash
#!/usr/bin/env bash
API="https://api.github.com/repos/vorssaint/vorssaint-utils/releases/latest"
URL=$(curl -s "$API" | jq -r '.assets[] | select(.name|endswith(".dmg")) .browser_download_url')
curl -L -o "vorssaint-latest.dmg" "$URL"
echo "Downloaded latest release to vorssaint-latest.dmg"

```

### Opening the Browser Programmatically

To launch the releases page from a macOS application:

```swift
import AppKit

if let url = URL(string: "https://github.com/vorssaint/vorssaint-utils/releases/latest") {
    NSWorkspace.shared.open(url)
}

```

## Key Source Files for Release Management

The vorssaint-utils codebase contains specific services managing version detection:

- **[`Sources/Vorssaint/Services/Update/UpdateService.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/Vorssaint/Services/Update/UpdateService.swift)** — Constructs the GitHub API request URL and handles the network call for the latest release information.
- **[`Sources/Vorssaint/Services/AppUpdates/AppUpdatesSupport.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/Vorssaint/Services/AppUpdates/AppUpdatesSupport.swift)** — Manages version comparison algorithms and update notification user interface logic.
- **`ReleaseAssets/`** — Contains example release artifacts demonstrating the naming convention for distributable files.
- **[`CHANGELOG.md`](https://github.com/vorssaint/vorssaint-utils/blob/main/CHANGELOG.md)** — Documents the historical progression of releases and feature additions.

## Summary

- The latest release of vorssaint-utils resides at `github.com/vorssaint/vorssaint-utils/releases/latest`, which redirects to the current version tag.
- The **UpdateService** class queries `api.github.com/repos/vorssaint/vorssaint-utils/releases/latest` to detect available updates automatically.
- Release assets follow the pattern `vorssaint-<version>-showcase-1.dmg` and can be downloaded via browser or API.
- Swift, shell scripts, and browser automation can all programmatically access the latest release metadata and binaries.

## Frequently Asked Questions

### Where is the latest release of vorssaint-utils hosted?

All releases are hosted on GitHub Releases under the vorssaint/vorssaint-utils repository. The permalink `https://github.com/vorssaint/vorssaint-utils/releases/latest` always redirects to the most recent version, making it suitable for bookmarks and documentation links.

### How does vorssaint-utils check for updates automatically?

The application uses the **UpdateService** class defined in [`Sources/Vorssaint/Services/Update/UpdateService.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/Sources/Vorssaint/Services/Update/UpdateService.swift). This service constructs a request to the GitHub API endpoint for the latest release, parses the JSON response to extract the version tag, and compares it against the currently installed version using logic in [`AppUpdatesSupport.swift`](https://github.com/vorssaint/vorssaint-utils/blob/main/AppUpdatesSupport.swift).

### What is the naming convention for vorssaint-utils release assets?

Release assets are packaged as macOS disk images with names following the pattern `vorssaint-<version>-showcase-1.dmg`, where `<version>` corresponds to the Git tag (such as `3.1.4` or `3.2.0`). These assets appear in the `assets` array of the GitHub API response with corresponding `browser_download_url` values.

### Can I download the latest release using a command-line script?

Yes. You can query the GitHub API using `curl` and parse the JSON with `jq` to extract the download URL for the `.dmg` file, then download it directly. This method requires no browser interaction and is suitable for automated deployment scripts or package managers.