Install and update problems

Use this page when Fabricator will not open, the installer is blocked, or an update cannot be applied.

Windows says the installer is uncommon

You see a Windows SmartScreen warning when you run Rayfin Fabricator_<version>_x64-setup.exe.

Fabricator's Windows installer is Authenticode code-signed and shows the verified publisher as Sachin Patney. SmartScreen reputation is still built per certificate and download, so early or uncommon downloads can warn even when the installer is signed.

1. Confirm you downloaded the installer from the latest GitHub release.
2. In the SmartScreen dialog, select More info.
3. Confirm the publisher is Sachin Patney.
4. Select Run anyway.
5. If Windows still blocks the installer, download the asset again from GitHub Releases.

If the warning looks different or the publisher is not shown as expected, stop and Report a problem.

macOS says Fabricator is damaged and can't be opened

You see "Rayfin Fabricator" is damaged and can't be opened, or macOS refuses to launch the app after you drag it into Applications.

The macOS Apple Silicon build is ad-hoc signed but not notarized. macOS can quarantine the app on download and describe that quarantine as damage.

1. Confirm you downloaded the Rayfin Fabricator_<version>_aarch64.dmg asset from the latest GitHub release.

2. Drag Rayfin Fabricator into Applications.

3. Open Terminal.

4. Run:

   xattr -dr com.apple.quarantine "/Applications/Rayfin Fabricator.app"

5. Open Fabricator again from Applications.

As an alternative, Control-click the app and choose Open. The xattr command is the most reliable fix.

If the app still will not open, Report a problem.

An update won't install or keeps prompting

You may see Update available, a Fabricator <version> is ready to install. prompt, an Update <version> is ready to install banner, a Downloading update <version>… banner, or "Installing update…".

Fabricator checks GitHub Releases when it starts, every 4 hours while it's open, and as soon as your connection comes back after a check failed. It downloads a signed update in the background. An update found at startup offers Update now or Later. Choosing Later keeps the app open and leaves the banner available with Restart & update. An update found while you work goes straight to the banner.

1. If you see Update available, select Update now. Fabricator restarts to apply the update.
2. If you chose Later, use the update banner and select Restart & update when you are ready.
3. If no update shows up when you expect one, check your network. Fabricator checks again once your connection is back. To check right away, restart Fabricator.
4. If the banner stays on Downloading update <version>… or "Installing update…" for a long time, restart Fabricator. It checks for the update again when it starts.
5. If your installed build predates auto-update support, install the latest release manually once from GitHub Releases. After that, in-app updates work.
6. If you see "A required update must be installed to continue.", leave Fabricator open until it restarts. If it fails, install the latest release manually.

If updates keep failing after a manual reinstall, Report a problem.