How to Completely Uninstall Vorssaint-Utils: A Step-by-Step Guide

The vorssaint-utils repository provides a dedicated uninstaller script in Tools/uninstall.sh that terminates all processes, resets macOS privacy permissions, and purges every associated file to fully remove the application from your system.

Vorssaint-Utils is an open-source macOS utility for managing fan control and sleep behavior distributed via the vorssaint/vorssaint-utils repository. When you need to eliminate every trace of the software—including daemon registrations, TCC grants, and cached data—the project includes a comprehensive shell script that automates the complete cleanup process. This guide explains how to execute a full uninstallation based on the actual source implementation.

What the Built-in Uninstaller Removes

The Tools/uninstall.sh script performs a six-stage cleanup sequence to ensure no residual state remains on your Mac:

• Running processes – Executes pkill -x Vorssaint and pkill -x VorssaintUtils to immediately terminate the main application and helper binary【/Tools/uninstall.sh#L16-L19】
• System daemons and login items – Invokes the bundled binary with --uninstall to deregister the fan helper daemon and remove login items, then verifies the launchctl service is fully removed【/Tools/uninstall.sh#L21-L33】【/Tools/uninstall.sh#L39-L45】
• macOS privacy permissions – Runs tccutil reset All com.vorssaint.utils to revoke all Accessibility and Screen Recording grants from the macOS Privacy database【/Tools/uninstall.sh#L54-L56】
• Application files and caches – Deletes the app bundle from /Applications, removes the com.vorssaint.utils preferences plist, saved-state files, and recursively purges directories under ~/Library/Application Support, Caches, HTTPStorages, and ByHost【/Tools/uninstall.sh#L57-L77】
• Sudoers configuration – Removes the optional password-free closed-lid rule via AppleScript prompt if it was previously installed【/Tools/uninstall.sh#L78-L82】
• Sleep settings restoration – Checks the pmset configuration and warns if sleep remains disabled, providing the command to manually re-enable it【/Tools/uninstall.sh#L90-L101】【/Tools/uninstall.sh#L112-L120】

When all stages complete successfully, the script outputs “✓ Vorssaint fully removed.” and exits with status 0. If components persist, it exits with status 1 and directs you to use the in-app advanced uninstall option.

Step-by-Step Uninstallation Methods

You can remove vorssaint-utils using either the Homebrew workflow or the manual script approach, depending on your installation method.

Method 1: Homebrew Uninstallation (Cask Users)

If you originally installed the tool via Homebrew, begin with the standard cask removal:

brew uninstall --cask vorssaint

This command removes the application bundle itself but does not clean preferences, caches, or privacy permissions. You must subsequently run the built-in uninstaller script to purge these residual files completely.

Method 2: Comprehensive Uninstall Script

For a complete removal—including all support files, daemons, and permissions—execute the dedicated uninstaller located at the repository root:

# Navigate to the repository directory

cd /path/to/vorssaint-utils

# Run the comprehensive uninstaller

./Tools/uninstall.sh

The script targets files using the bundle identifier com.vorssaint.utils (defined in Package.swift) to ensure accurate deletion of Library resources. Certain operations, such as resetting TCC permissions and removing the sudoers rule, require administrative privileges and will prompt accordingly.

Handling Lingering Components

If the uninstaller reports incomplete removal or exits with status 1, address these specific scenarios:

Fan helper daemon persists: If the script warns that the fan helper remains registered with launchctl, reinstall the application temporarily and use the Advanced Uninstall option within the app UI. This triggers the bundled binary’s --uninstall logic with elevated privileges to force-deregister the service【/Tools/uninstall.sh#L21-L33】.

Sleep remains disabled: The script checks your current pmset state and alerts you if disablesleep is still active. To manually restore normal sleep behavior, run:

sudo pmset disablesleep 0

This reverses the sleep prevention that vorssaint-utils may have enabled during operation【/Tools/uninstall.sh#L112-L120】.

Summary

• Vorssaint-utils provides a complete uninstall solution via Tools/uninstall.sh that handles application termination, daemon deregistration, permission resets, and file deletion.
• The script identifies resources using the bundle identifier com.vorssaint.utils to clean ~/Library/Application Support, Caches, HTTPStorages, and preference plists.
• Homebrew users should run brew uninstall --cask vorssaint first, then execute the script to remove residual data.
• The uninstaller resets TCC permissions via tccutil and removes optional sudoers rules through AppleScript prompts.
• Verify sleep functionality after uninstallation by checking pmset status and running sudo pmset disablesleep 0 if necessary.

Frequently Asked Questions

How do I verify that vorssaint-utils was completely removed?

Run the Tools/uninstall.sh script and check for the success message “✓ Vorssaint fully removed.” with exit status 0. You can manually confirm removal by ensuring pgrep -x Vorssaint returns no results and that ~/Library/Application Support/com.vorssaint.utils no longer exists. The script also verifies that the launchctl service for the fan helper is no longer loaded【/Tools/uninstall.sh#L39-L45】.

Does the uninstaller remove all macOS privacy permissions?

Yes, the script executes tccutil reset All com.vorssaint.utils which clears all Accessibility and Screen Recording permissions for the application from the macOS TCC database【/Tools/uninstall.sh#L54-L56】. This ensures the app disappears entirely from your System Settings > Privacy & Security panels.

What should I do if the uninstaller says the fan helper is still registered?

If the script detects a lingering fan helper service after attempting removal, it exits with status 1 and recommends reinstalling the app to access the in-app Advanced Uninstall feature. This alternative method uses the bundled binary’s --uninstall flag to perform a force-deregistration of the daemon, which is more aggressive than the standard shell-based approach【/Tools/uninstall.sh#L21-L33】.

Can I uninstall vorssaint-utils without using the script?

While you can manually drag the app to the Trash, this leaves behind preference files in ~/Library/Preferences, cache data in ~/Library/Caches, the fan helper daemon registered with launchctl, and potentially a sudoers rule for closed-lid operation. The Tools/uninstall.sh script is the only supported method to ensure complete removal of all components, including the TCC permission reset and sudoers cleanup【/Tools/uninstall.sh#L54-L56】【/Tools/uninstall.sh#L78-L82】.

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