RapidRAW Logo RapidRAW
Verified in v1.6.7
Documentation Menu

Troubleshooting on macOS

RapidRAW needs macOS 13 Ventura or newer. Download the aarch64 version for Apple Silicon (M1 and later) and the x64 version for Intel Macs.

"RapidRAW is damaged and can't be opened"

macOS shows this for apps that are not notarized by Apple. The app is not actually damaged. Open Terminal and run:

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

Then start RapidRAW normally. If the message comes back after installing an update, run the command again.

Crash when opening a photo

  1. Open Settings → Processing → Processing Backend.
  2. Choose Metal, click Save & Relaunch and try again.
  3. If that fails, choose OpenGL.

If you still have problems, also try turning off WGPU Direct Rendering in the same section.

AI masks or denoise hang

Some AI models use the GPU through Core ML. If AI features hang or crash, turn off Settings → General → Generative AI → GPU Acceleration.

RAW files look different than in Apple Photos

RapidRAW uses its own RAW decoder. On macOS 27 or later you can switch to Apple's decoder with Settings → Processing → Apple RAW 9 Engine. It is slower, needs a camera that Apple supports, and gives results closer to Apple's own apps.

The log file

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

In Finder, press Cmd+Shift+G and paste the path, or use Settings → Processing → Data Management → Logs → Show. The log is cleared on every start, so copy it before relaunching after a crash. Crash reports from macOS itself are in ~/Library/Logs/DiagnosticReports/.

See also