> For the complete documentation index, see [llms.txt](https://docs.realmacsoftware.com/classic-manual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmacsoftware.com/classic-manual/user-manual/troubleshooting/how-to-report-a-bug.md).

# How to Report a Bug

Should you come across a bug in RapidWeaver there are a few things we need to help resolve the bug or issue you are seeing.

All bug reports should be sent to <support@realmacsoftware.com> so we can deal with them more swiftly. We'll contact you directly should we require any more information.

{% hint style="info" %}
**Helpful information when reporting a bug**

Please try to send us as much information as you can about the bug, this will help us locate and fix it much quicker.&#x20;

* RapidWeaver version
* macOS version
* Steps to reproduce the bug (bonus points for an example project)
* Screen recording (or screenshots)
* Exact error message as it appears
* Crash log
  {% endhint %}

### **How to record your screen**

Use QuickTimePlayer.app, this can be found in your Applications Folder.

To create a simple recording, **choose File › New Screen Recording** from the menu. Click the red record button, then follow the instructions on the screen. To save, choose **File › Export** and select the quality.

Alternatively, you can use the keyboard shortcut [command-shift-5](/classic-manual/user-manual/keyboard-shortcuts.md) to bring up the onscreen Screen Recording controls.

<figure><img src="/files/00cHiCyDAa1FlaHDu5hf" alt=""><figcaption></figcaption></figure>

### How to find a crash log <a href="#crash-log" id="crash-log"></a>

Whenever an application on macOS crashes, it’ll automatically create a .crash file containing details as to what may have caused the crash. In the rare event that RapidWeaver crashes, sending us a crash log will help us find out what caused the crash, and how we can fix it.&#x20;

How to find your crash Logs(s):

* In the Finder, go to your Applications folder, then Utilities and launch Console.app
* Under the User Diagnostic Reports portion of the sidebar, locate the most recent crash.
* When found, Control-click it, and then select “Reveal in Finder” from the shortcut menu.
* Copy, or drag out the selected file from the Finder window and attach it to an email and send it to <support@realmacsoftware.com>