Troubleshooting on macOS

App crashes when opening an image / entering edit mode

If RapidRAW crashes immediately when you try to start editing a picture, it is almost always due to the automatic selection of the GPU backend.

1. Open the splash screen → Settings (gear icon).
2. Navigate to the Processing tab.
3. Find the Processing Backend setting.
4. Change it from Auto to a specific backend. On macOS, try Metal first; if that fails, try OpenGL.
5. Restart the app and try opening the image again.

OpenGL is the fallback that works on most platforms. It's slower than Metal, but if Metal can't initialize on your specific hardware/driver combo, OpenGL will almost always start.

"RapidRAW is damaged and can't be opened" (Gatekeeper)

Cause: macOS Gatekeeper quarantines unsigned third-party apps downloaded from the web. RapidRAW isn't yet notarized.

Fix: Open Terminal and run:

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

Then launch normally. You only need to do this once per install.

Logs

When filing a bug, attach the log file:

~/Library/Logs/io.github.CyberTimon.RapidRAW/app.log

In Finder press Cmd+Shift+G and paste the path. See Filing a Bug Report for the full process and the bug template.

See also

• GPU & Drivers for the Metal backend.
• File Issues for unsupported RAWs and sidecar problems.
• Filing a Bug Report.