installation issues

This page covers common problems when installing or launching twig on macOS.

"twig can't be opened because it is from an unidentified developer"

macOS Gatekeeper blocks apps not from the App Store or identified developers.

solution

  1. Right-click (or control-click) on twig in your Applications folder
  2. Select "open" from the context menu
  3. In the dialog, click "open"

This only needs to be done once. Future launches will work normally.

alternative: system preferences

  1. Go to system preferences > security & privacy > general
  2. You should see a message about twig being blocked
  3. Click "open anyway"
  4. Confirm in the dialog

"twig is damaged and can't be opened"

This usually means the app was quarantined during download.

solution

Remove the quarantine attribute:

  1. Open Terminal (Applications > Utilities > Terminal)
  2. Run this command: 
    xattr -cr /Applications/Twig.app
  3. Try opening twig again

permission errors

Twig needs permission to access files on your system.

disk access

If twig can't read your project files:

  1. Go to system preferences > security & privacy > privacy
  2. Select "files and folders" or "full disk access"
  3. Click the lock to make changes
  4. Add twig or enable its access
  5. Restart twig

downloads folder

If you can't open projects from downloads:

  1. Move your project to your home folder or documents
  2. Or grant twig access to the downloads folder in privacy settings

twig won't start

If twig doesn't open at all:

check activity monitor

  1. Open Activity Monitor (Applications > Utilities)
  2. Search for "twig"
  3. If it's running but not showing, select it and click the X to quit
  4. Try opening again

check for multiple instances

Only one instance of twig should run at a time. If you see multiple:

  1. Quit all instances via Activity Monitor
  2. Relaunch twig

check disk space

Twig needs a few hundred MB of free space to run. Check your available storage:

  1. Click the Apple menu > about this Mac
  2. Select storage
  3. Ensure you have free space

dmg won't mount

If the downloaded DMG file won't open:

re-download

The download may be corrupted:

  1. Delete the downloaded file
  2. Download again from GitHub releases
  3. Try mounting the new file

check the file

Verify the download completed:

  1. Right-click the DMG file > get info
  2. Check the file size (should be ~123MB)
  3. If smaller, the download was incomplete

m1/m2/m3 compatibility

Twig currently requires Apple Silicon:

  • Supported: M1, M2, M3, and newer Apple Silicon Macs
  • Not supported: Intel-based Macs

To check your Mac:

  1. Apple menu > about this Mac
  2. Look for "chip" - it should say M1, M2, M3, etc.

Intel Mac support is planned for future releases.

still stuck?

If none of these solutions work:

  1. Check GitHub issues for similar problems
  2. Create a new issue with details about what you've tried
  3. Include your macOS version and any error messages