Installation problems

Clicking the installer link opens a GitHub page instead of installing

That’s expected — README links open files in the browser; they don’t execute installer scripts. Copy the install command into Terminal instead:

curl -fsSL https://raw.githubusercontent.com/udhawan97/Orifold/main/install.sh | zsh

The download didn’t start

The Download for macOS button is a plain link to the DMG on GitHub. If nothing downloaded, your browser may have blocked it or lost the connection. Click it again, or grab it straight from the latest release — download Orifold.dmg (or Orifold-<version>-macOS-universal.dmg).

macOS warns the app is from an unidentified developer

Release builds are ad-hoc signed but not notarized. The one-line installer and Homebrew cask clear the download quarantine automatically. From the DMG, the first launch takes one step:

macOS 14: right-click Orifold → Open → Open.
macOS 15: open Orifold once (it’s blocked), then System Settings → Privacy & Security → Open Anyway.

macOS says the app is “damaged and can’t be opened”

This is the quarantine flag on an un-notarized download, not a corrupt file. Install via the one-line installer or Homebrew cask (they clear it), or, if you already dragged the app in from the DMG, clear it once from Terminal:

xattr -dr com.apple.quarantine /Applications/Orifold.app

Then open Orifold normally.

If this warning appeared immediately after choosing Install and Restart in Orifold v0.8.13 or earlier, the old app’s generated updater command was blocked before it ran; your installed app and documents were not replaced. Run the one-line installer once to install v0.8.14 or later. In-app updates remove that launch-blocking attribute from v0.8.14 onward.

Double-clicking a .command file says it cannot be opened

Open Terminal in the project folder and run:

chmod +x "Install or Update Orifold.command" "Uninstall Orifold.command" "Install or Update Orifold.app/Contents/MacOS/OrifoldInstaller" scripts/install-mac.sh scripts/install-mac.command scripts/uninstall-mac.sh

Then double-click Install or Update Orifold.app again from Finder.

The installer says no prebuilt release is available

The GitHub release asset Orifold.zip hasn’t been published yet, or couldn’t be downloaded. Wait for the release workflow, then rerun the installer. If you need to build from source in the meantime:

curl -fsSL https://raw.githubusercontent.com/udhawan97/Orifold/main/install.sh | ORIFOLD_ALLOW_SOURCE_BUILD=1 zsh

Something failed and the Terminal window closed too fast

Check .build/install.log in the project folder for build output, and ~/.orifold/prebuilt-install.log for the prebuilt install attempt.

Still stuck?

Open an issue on GitHub.

Install Orifold