Skip to content

Update & uninstall

When to use this

A new version of Orifold is out, or you want to remove the app entirely.

Choose Check for Updates… from the Orifold menu, or open Settings → Updates. If a newer version exists, click Download — Orifold fetches the disk image and checks it against the release’s published SHA-256 checksum before it can install. When it’s verified, click Quit, Install, and Relaunch…. Orifold blocks the handoff if any open document has unsaved changes; otherwise it closes, installs the verified app, relaunches, and reopens the documents that were open.

Automatic checks are off by default. Turning them on lets Orifold look about once a day — only ever a version check. It never downloads or installs anything on its own, and a check never sends anything but a request for the latest version number.

The About Orifold window (in the Orifold menu) also shows, right under the version, whether you’re up to date or an update is waiting — one click there opens the same Software Update window.

When Orifold installs an update, it quietly keeps a verified copy of the version you were on. If a new build ever misbehaves, choose Help → Restore Previous Version…. Orifold confirms first, makes sure your open documents are saved, then closes, checksum- and signature-verifies the saved copy, swaps it back into place, and reopens — your documents untouched. The menu item is greyed out until there’s actually a saved version to go back to.

The verified restore action is available only while Orifold can launch. A trusted signed update also leaves an explicit Restore Previous Orifold.command beside the installed app before the swap, with the exact target and archive bound into it. Double-click it only when you have chosen to restore. It refuses to run while Orifold is open, shows you exactly which app it would replace, and does nothing until you type YES; it then verifies the archive, bundle identity, publisher, signature, and Gatekeeper state before changing anything, and keeps the current app if a step fails. Development or ad-hoc builds intentionally do not enable automatic swapping or this helper. If the helper is unavailable, download the version you want from Orifold’s GitHub Releases and reinstall it manually. Your documents are separate from the app bundle; do not delete app data while reinstalling.

Double-click Orifold.command on your Desktop. It checks the latest release before launching, and sweeps up any stray Orifold.app copies (for example, one dragged straight into /Applications) so only one install remains. That’s the entire procedure.

Terminal window
brew update
brew upgrade --cask udhawan97/orifold/orifold

Double-click Uninstall Orifold.command on your Desktop. It removes the app, the Desktop helpers, the installer cache, and app data.

Terminal window
brew uninstall --cask udhawan97/orifold/orifold

To uninstall but keep preferences, caches, and sandbox data:

Terminal window
curl -fsSL https://raw.githubusercontent.com/udhawan97/Orifold/main/scripts/uninstall-mac.sh | zsh -s -- --keep-user-data

After updating: the same Desktop helpers, a newer app version. After uninstalling: no Orifold.app, no Desktop helpers, and (unless you kept data) no app data remaining.