# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.realmacsoftware.com/classic-manual/user-manual/troubleshooting/how-to-report-a-bug.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
