# How to troubleshoot Screen Recording issues in Birdie Extension

If the Birdie Chrome extension isn’t capturing your screen during recordings, follow the steps below to ensure screen recording permissions are properly configured.

***

## Symptoms

* Birdie recordings show a blank or black screen instead of your content.
* You don’t see a prompt asking for screen recording permissions when starting a recording.
* You face a "recording is empty" or "no video stream" error

***

## Troubleshooting Steps

**Step 1: Grant Screen Recording Permissions in Chrome**

1. Open the Birdie Chrome extension by clicking the Birdie icon in your browser’s address bar.
2. Click on **Start recording**.
3. If prompted, choose the specific screen, window, or tab you’d like to share.
4. Click **Allow** or **Share** to grant Birdie permission to capture your screen.

<figure><img src="/files/q2KGxG5EpXFQZUyDO4Cs" alt="" width="375"><figcaption></figcaption></figure>

If you don’t see the prompt, proceed to the next steps to check system-level permissions.

***

**Step 2 A: Check Screen Recording Permissions in macOS Settings**

If you're using macOS, ensure that Google Chrome has permission to record your screen:

1. Open **System Preferences** (or **System Settings** on macOS Ventura and later).
2. Navigate to **Privacy & Security > Screen Recording**.
3. In the list of apps:

   * Select **Google Chrome** and completely remove it using the minus (–) icon.
   * Add **Google Chrome** back by clicking the plus (+) icon and selecting it again

   **📌 &#x20;**<mark style="color:orange;">**Note**</mark><mark style="color:orange;">: It’s important to</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**remove it entirely**</mark><mark style="color:orange;">, not just disable/enable the toggle</mark>.&#x20;
4. If prompted, restart Chrome to apply the changes.

<figure><img src="/files/kd0ML6i14vkvT2JSNgv5" alt="" width="375"><figcaption><p><strong>Check Screen Recording Permissions in macOS Settings</strong></p></figcaption></figure>

> **Note**: If Chrome does not appear in the list, try starting a Birdie recording to trigger the permission request. macOS typically adds apps to the list only after they request screen recording access.

***

**Step 2 B: Check Screen Recording Permissions in Windows Settings**

If you're using Windows, confirm that Google Chrome can access your screen:

1. Open the **Start Menu** and select **Settings**.
2. Navigate to **Privacy > App Permissions** and select **Screen Recording** (or a similar option based on your Windows version).
3. Ensure that the toggle for **Allow desktop apps to record your screen** is enabled.
4. In the list of apps, ensure **Google Chrome** is listed and enabled.

   Example screenshot:<br>

> **Note**: If Chrome does not appear in the list, ensure you’ve attempted to start a screen recording recently.

***

**Step 3: Restart Chrome**

After adjusting your system settings, restart Chrome to ensure the changes take effect.

***

**Step 4: Restart Your Computer**

Don't underestimate it. This old trick always helps.

***

#### Additional Tips

* **Check for browser updates**: Ensure Chrome is updated to the latest version for compatibility with screen recording features.
* **Try a different browser tab or window**: If one specific tab fails, try recording another to rule out content-specific restrictions.\`
* **Reload Birdie extension**: If problems persist, reloads the Birdie Chrome extension to refresh its settings and permissions.

***

By following these steps, you should be able to resolve screen recording issues and successfully capture your content. If you continue to experience issues, contact our support team for further assistance.\ <br>


---

# 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.birdie.so/birdie-docs/record-my-screen/troubleshooting/how-to-troubleshoot-screen-recording-issues-in-birdie-extension.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.