← Back to GPRaw

Support

How can we help?

Requirements

GPRaw requires macOS 15 (Sequoia) or later. The App Store only offers it to compatible Macs, so if it installed, you're good.

Getting GPR files onto your Mac

A GoPro writes a GPR only when RAW is enabled in the camera's photo settings. Each GPR sits in a DCIM folder on the memory card alongside the JPEG of the same shot, sharing the same filename with a .GPR extension.

Copy them like any other files: insert the card in a reader, or connect the camera and use its transfer app, then drag the GPRs to your Mac. Once on disk — or on a mounted card — you can open them directly in GPRaw.

Opening photos

Double-click a GPR, drop one onto the GPRaw window, or use File > Open. The photo opens in the editor with the adjustment panel on the right. Use the zoom slider at the bottom; double-click it to fit the window. The image sharpens a moment after you stop moving a dial — that's GPRaw finishing the full-resolution render.

Open multiple GPR files together and GPRaw creates a sequence: frames appear in a filmstrip along the bottom, one set of dials grades all of them, and File > Export writes a movie. This is the way to grade a timelapse or photo burst.

To make GPRaw the default app for GPR files, use Default GPR Files to GPRaw in GPRaw > Settings. To revert, select a GPR in Finder, choose File > Get Info, and pick another app under "Open with".

The free version and unlocking

GPRaw is free to view with. Opening photos, browsing in the editor, Finder thumbnails, and Quick Look previews all work without paying. Editing and all export options require the full version — a single in-app purchase. Choose Pay to Unlock Full Features in the GPRaw menu, or tap any locked control.

The purchase is tied to your Apple Account and carries to your other Macs. If GPRaw doesn't recognise it there, open the unlock dialog and choose Restore Purchase. The unlock works offline once recorded.

Editing

Editing is non-destructive — GPRaw never writes to the GPR file itself. Revert to Original in the editor returns the photo to its out-of-camera state. Hold the compare button to see the unedited version at any time.

The panel has five sections:

  • Light: Exposure, Contrast, Highlights, Shadows, Whites, Blacks.
  • Color: Temperature, Tint, Vibrance, Saturation.
  • Crop: Straighten dial, rotate and flip buttons, aspect ratio menu, Select Crop for dragging corners, and Smart Crop, which proposes a crop you can nudge or cancel before it lands.
  • Lens Correction: Removes fisheye curvature. Off keeps the full wide field of view; 1.00 makes lines fully straight with the hardest edge crop; 0.60 is close to the camera's own Linear mode. Protect Subject corrects the edge-stretching that straightening applies to people in the frame while keeping background lines straight.
  • Portrait: Depth-based background blur, with Strength, an Aperture dial for blur falloff, and Select Focus Point to choose what stays sharp.

Each section header has a reset arrow for its dials; double-clicking any dial resets just that one.

If the Lens Correction dial is grey, GPRaw has no lens profile for that photo. Profiles cover HERO5 through HERO13. Other cameras, and files already corrected by another app, cannot use the dial.

Exporting

File > Export (or the toolbar button) writes a copy with your edits baked in. Choose format, bit depth, size, and whether to keep the original metadata:

  • JPEG for sharing; PNG and TIFF for lossless work; HEIC and AVIF for smaller files; DNG to keep a raw file.
  • Full Size is the camera's native pixel dimensions. Half Size and Quarter Size show exact output dimensions.
  • Preserve Metadata carries EXIF, GPS, and camera data. Orientation is always preserved.

DNG is available only while the raw data can carry your edits. Lens correction travels in a DNG as instructions any raw editor can apply, but background blur and cropping cannot be stored that way — once you use them, DNG goes grey. Reset those dials or export in another format to bring it back.

Exporting a sequence writes a movie. Codecs: ProRes 4444, ProRes 422 HQ, HEVC 10-bit, HEVC 8-bit, and H.264, at 24, 25, 30, or 60 fps. Every frame is rendered at full size, so movie exports take a while. If you try to quit mid-export, GPRaw warns you rather than leaving an unplayable file.

Quick Share skips all of that — it converts what's on screen to a half-size JPEG and opens the macOS share sheet, so you can AirDrop or message a photo without saving a file. GPRaw cleans up after itself.

Finder and Quick Look

GPRaw installs its Finder, Quick Look, and Photos extensions with the app. Finder shows real thumbnails for GPR files, the space bar previews them, and three quick actions appear when GPR files are selected — in the Finder preview pane and under right-click > Quick Actions:

  • GPRaw: Export — saves converted copies with the same options as the in-app export dialog.
  • GPRaw: Quick Share — converts the selection and opens the share sheet immediately, nothing to save or clean up.
  • GPRaw: Add to Photos — imports the selection into your Photos library as DNGs and opens Photos.

All extensions are managed in System Settings > General > Login Items & Extensions. If quick actions don't appear in Finder, open that pane, click the (i) next to System Services, and enable the GPRaw actions. New actions from any app start off by default and may appear under the More button in the preview pane until you promote them.

Apple's own Convert Image quick action also appears for GPR files but fails on them — macOS itself cannot read the GoPro raw format. Use GPRaw: Export instead.

Photos

GPRaw appears in Photos twice. GPRaw: Add to Photos in Finder imports GPR files into your library; inside Photos, Edit > the extensions button offers GPRaw, giving you the same dials for any photo in your library — non-destructively and revertable like any Photos edit. If GPRaw is missing there, enable it under Photos Editing in System Settings > General > Login Items & Extensions.

To save exports to your library, GPRaw requests add-only access from macOS. That permission lets it add new items only — it cannot read, change, or delete existing photos. If you decline, all other GPRaw features still work and exports go to files instead.

Note: if you decline the add-only request, macOS provides no way to ask again and doesn't list add-only apps in its Photos privacy settings, so Add to Photos stays unavailable on that Mac.

Settings

GPRaw > Settings has one rendering option: Maximum Image Quality. It sends pixels through Apple's newest raw decoder, which is slower and requires macOS 27 or later — the checkbox is disabled until then. Turning it on re-renders the currently open photo immediately.

The same window has the two setup steps: granting add-only Photos access, and setting GPRaw as the default app for GPR files.

If something is not working

A photo will not open

GPRaw reports a decode failure when a file isn't a GPR, or is damaged or incomplete — a partial copy off a card is the usual cause, so try copying it again. GPR files from a camera newer than the format GPRaw supports can also fail; that's worth reporting.

Finder shows generic icons instead of thumbnails

Open GPRaw once so macOS registers it, confirm the thumbnail and preview extensions are enabled in System Settings > General > Login Items & Extensions, then restart your Mac to clear the icon cache. If another app that also claims GPR files is installed, macOS may be routing previews to it — removing or disabling that app helps.

Editing controls are greyed out

Either you're on the free version — the app menu reads GPRaw (Free Version) and any locked control opens the unlock dialog — or it's the Lens Correction dial specifically, which requires a supported camera profile as described above.

Renders and exports feel slow

Full-resolution raw processing is genuinely heavy, especially on larger sensors. If Maximum Image Quality is on, that's several times the work of a standard render — turn it off if you don't need it. Movie exports scale with frame count and take the longest.