โ Common Causes and Fixes
| What might be wrong | How to fix it |
|---|---|
| Selected wrong screen or window to share | When the screen sharing dialog appears, carefully select โEntire Screenโ or your primary monitor (usually called โScreen 1โ or โDisplay 1โ), not โApplication Windowโ or โChrome Tab.โ If you selected a specific application thatโs minimized or closed, youโll see black. Click โStop Sharingโ and restart, selecting the correct entire screen option. |
| macOS screen recording permission not granted | Mac: System Settings > Privacy & Security > Screen Recording > check the box next to your browser (Chrome, Safari, Firefox, Edge). Your browser must completely quit and restart after granting this permission. Without screen recording permission, macOS shows a black screen instead of your actual display for security reasons. |
| Hardware acceleration causing conflictsDisable hardware acceleration in your browser. | Chrome/Edge: Settings > System > turn OFF "Use hardware acceleration when available" > restart browser. Firefox: Settings > General > Performance > uncheck "Use hardware acceleration" > restart.Hardware acceleration can cause black screens with certain graphics cards or drivers. |
| Sharing application window thatโs minimized | If you selected a specific application window to share (not entire screen), that window must remain open and visible on your screen. Minimizing it shows black. Either maximize the application or switch to sharing your entire screen instead, which shows everything regardless of whatโs open. |
| Multiple monitors with wrong monitor selected | If you have multiple monitors, verify youโre sharing the correct one. When prompted, select the monitor where your test content is displayed. If you selected your secondary monitor but your test is on the primary, viewers see black or a blank desktop. Disconnect extra monitors if unsure which is which. |
| Browser doesnโt have permission to capture specific window | Some operating systems require additional permissions to capture certain windows. Mac: System Settings > Privacy & Security > Screen Recording must include your browser. Windows: Ensure no applications are blocking screen capture (some corporate security software prevents it). Try sharing entire screen instead of specific windows. |

