Installation problems
Clicking the installer link opens a GitHub page instead of installing
Section titled “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 | zshThe download didn’t start
Section titled “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
Section titled “macOS warns the app is from an unidentified developer”Public builds are ad-hoc signed and not Apple-notarized unless the release states otherwise. Confirm the download source and checksum, then follow Apple’s guidance for opening a trusted app from an unidentified developer. Terminal and Homebrew installation clear quarantine; they do not add notarization.
macOS says the app is damaged or will harm your computer
Section titled “macOS says the app is damaged or will harm your computer”Do not assume this is only a quarantine flag. Download again from the official release, compare SHA-256 against its manifest, and report a repeatable mismatch or alert. Apple explains that damaged software may be corrupted or modified and that malware alerts are a different condition. Follow Apple’s alert guidance before deciding whether to open a download.
Double-clicking a .command file says it cannot be opened
Section titled “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.shThen double-click Install or Update Orifold.app again from Finder.
The installer says no prebuilt release is available
Section titled “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 zshSomething failed and the Terminal window closed too fast
Section titled “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.