RapidRAW Logo RapidRAW
Verified in v1.6.7
Documentation Menu

Filing a Bug Report

RapidRAW is developed mostly by one person. The biggest factor in how fast a bug gets fixed is how easy the report is to act on. A clear report with a log and steps to reproduce is often fixed in the next release.

Before you report

  1. Update. Check you have the latest version. Many bugs are already fixed.
  2. Search. Look through existing issues. If your bug is there, add your details as a comment instead of opening a new issue.
  3. Check the troubleshooting pages for Windows, macOS, Linux and GPU & Drivers.

Use the template

Open a Bug Report. It asks for:

  1. What happened, including error messages.
  2. What you expected.
  3. Steps to reproduce, numbered.
  4. Your operating system.
  5. Your RapidRAW version (shown on the start screen, for example 1.6.7).
  6. Extra information: GPU, driver version, what you already tried.
  7. Confirmation that you checked existing issues and the upstream projects for camera and lens support.

Ideas go into a Feature Request or Discussions.

Collect the log

The log contains GPU details, errors and crash traces. Always attach it.

System Location
Windows %LOCALAPPDATA%\io.github.CyberTimon.RapidRAW\logs\app.log
macOS ~/Library/Logs/io.github.CyberTimon.RapidRAW/app.log
Linux ~/.local/share/io.github.CyberTimon.RapidRAW/logs/app.log
Flatpak ~/.var/app/io.github.CyberTimon.RapidRAW/data/io.github.CyberTimon.RapidRAW/logs/app.log

The quickest way: Settings → Processing → Data Management → Logs → Show.

Important: the log is cleared every time RapidRAW starts. After a crash, copy app.log before you open RapidRAW again.

For the most useful log:

  1. Start RapidRAW.
  2. Reproduce the bug.
  3. Close RapidRAW (or let it crash).
  4. Copy app.log and attach it.

For even more detail, start RapidRAW with the environment variable RUST_LOG=debug.

The log contains file paths and system information, but no image data. Have a quick look before posting if you are worried about folder names.

When RapidRAW crashes

  • Attach the full log; the error is usually at the end.
  • Windows: also check Event Viewer → Windows Logs → Application for an "Application Error" about RapidRAW.exe.
  • macOS: look in ~/Library/Logs/DiagnosticReports/ for a crash report from that time.
  • Linux: run RapidRAW from a terminal to capture all output: RapidRAW 2>&1 | tee crash.log (or the AppImage / Flatpak command).

When a specific photo causes the problem

Sample files help a lot. Share the file (zipped) through a file host and link it in the issue. If the photo is private, ask on Discord about sharing it privately.

Where to report what

Problem Where
Bug in RapidRAW Bug Report
Feature idea Feature Request or Discussions
Question Discord, the fastest place for help
Camera not supported dnglab, with a CC0 sample set uploaded to RawDB. See File Formats.
Lens profile missing Lensfun
Mistake in these docs RapidRAW issues or Discord

Thank you

Every detailed bug report makes RapidRAW better for everyone. Thanks for taking the time.

See also