# 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](https://docs.realmacsoftware.com/classic-manual/user-manual/keyboard-shortcuts) to bring up the onscreen Screen Recording controls.

<figure><img src="https://3941723260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQxK7JyV6iH6ddgHOOt8v%2Fuploads%2F4RdBKs8TEeCULhicj336%2Fscreenshot-toolbar.jpg?alt=media&#x26;token=e39a75ec-1bf4-43de-a279-a318b4444f32" 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>