# How to Completely Uninstall Vorssaint-Utils: A Step-by-Step Guide > Completely uninstall vorssaint-utils with our step-by-step guide. Learn how to use the official uninstall script to remove all associated files and reset permissions. - Repository: [vorssaint/vorssaint-utils](https://github.com/vorssaint/vorssaint-utils) - Tags: how-to-guide - Published: 2026-09-09 --- **The vorssaint-utils repository provides a dedicated uninstaller script in [`Tools/uninstall.sh`](https://github.com/vorssaint/vorssaint-utils/blob/main/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`](https://github.com/vorssaint/vorssaint-utils/blob/main/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: ```bash 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: ```bash # 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`](https://github.com/vorssaint/vorssaint-utils/blob/main/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: ```bash 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`](https://github.com/vorssaint/vorssaint-utils/blob/main/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`](https://github.com/vorssaint/vorssaint-utils/blob/main/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`](https://github.com/vorssaint/vorssaint-utils/blob/main/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】.