knitted.studio
Menu

Install guide

Opening an unsigned preview.

The first installers are previews and are not signed yet. Your computer will warn you the first time. Here is how to get past it.

Why the warning appears

Signing an app with a developer certificate proves who made it. Early previews do not have one yet, so macOS and Windows treat them as from an unknown developer. Only open an installer you downloaded from this site or from the project’s GitHub releases, and compare its SHA-256 with the one listed on the download page.

macOS

  1. Open the downloaded disk image and drag knitted to Applications.
  2. Open knitted. macOS says “Apple could not verify knitted.app is free of malware”. Choose Done, not Move to Trash.
  3. Open System Settings, then Privacy & Security.
  4. Scroll to the Security section. You will see a note that knitted.app was blocked. Choose Open Anyway.
  5. Choose Open Anyway again and confirm with your password or Touch ID. knitted opens. You only do this once.

Prefer Terminal? xattr -dr com.apple.quarantine /Applications/knitted.app clears the flag macOS puts on downloads, and then knitted opens as usual. If macOS says knitted “is damaged”, the copy is from before the builds were signed or did not download whole: download it again.

Not sure which Mac you have? The Apple menu, About This Mac, says. A Chip line naming Apple M1 or later is Apple silicon. A Processor line naming Intel is an Intel Mac.

Windows

  1. Run the installer. A blue box says Windows protected your PC.
  2. Choose More info. The publisher shows as unknown.
  3. Choose Run anyway.
  4. Finish the installer as usual.

Linux

Linux does not show a signing warning. Make the AppImage executable (chmod +x) and run it, or install the package with your package manager.

Still stuck?

Read the troubleshooting page, or open an issue on GitHub.