Use macOS Screen Capture and choose its display, window or application method deliberately. Review the relevant permission and test the visible boundary with harmless windows before recording real material.
Select the appropriate ScreenCaptureKit scope on a Mac, review permissions, and test which windows appear in the recorded picture.
In this guide
Before you start
- A supported macOS version and current compatible OBS installation.
- A target app containing non-private test content.
Choose the smallest useful visual scope
A full-display demonstration and a single-app lesson have different exposure boundaries. Decide whether the viewer needs the entire desktop, one particular window, or the visible windows belonging to an application. Write that choice down before adjusting the capture source.
The macOS Screen Capture source uses ScreenCaptureKit and offers display, window and application methods. OBS documents picture capture on macOS 12.3–12.6 and picture with audio support on macOS 13 and later. Do not assume a tutorial using deprecated Mac capture sources describes the current source.
Review the capability you are actually using
Open OBS Studio → Review App Permissions when capture access needs attention. Screen Recording permission relates to desktop, window and app capture; camera and microphone permissions serve different devices. Enable the relevant capability and follow any system request to restart the application.
Keep the target window open with recognizable, harmless content. If it is absent from the list, inspect the source’s options for unnamed, hidden or fullscreen windows where relevant. Do not switch to capturing the entire desktop simply because that is the first item available.
Prove the capture boundary in a local sample
Select the intended method
Add macOS Screen Capture and choose Display, Window or Application as planned. Select the actual target and give the source a scope-specific name.
Look for: Preview contains the expected target rather than an accidental whole-desktop view.
Open a harmless comparison window
Move a separate app window in front of the target and open another window from the target app if the workflow uses one. Watch which content appears.
Look for: You can describe the real visual boundary of the chosen method.
Record the actual workflow
Make a local recording while switching documents or opening the dialogs you expect to demonstrate. Inspect picture and sound in the file.
Look for: The chosen scope includes the necessary demonstration without unexpected windows.
Check the steps that leave the main window
A lesson may include a file picker, settings window or pop-up that behaves differently from the main document. Rehearse those steps instead of discovering during narration that the audience cannot see the dialog. If a broader capture scope is necessary, prepare the desktop and close unrelated material first.
Pay attention when moving the target between displays or changing fullscreen state. The source may need a revised selection or visibility option. Keep those transitions in your test sequence if they are part of the real session; a static preview does not exercise them.
Confirm audio separately from visual permission
A correct picture does not prove the app’s audio is in the recording. Check the appropriate audio source, its meter and the saved track. On supported modern versions, a dedicated macOS Audio Capture source can make an audio-only route easier to understand.
If the picture is missing everywhere, revisit the relevant permission and selected target. If only one dialog is missing, investigate scope instead. Save a short note describing the chosen method, target and tested window transitions so the next recording begins with the same understood boundary.
Still stuck?
The main app records but its dialog does not.
Rehearse the dialog with the source’s window/application scope and visibility options; broaden capture only after checking what additional content it includes.
Sources & references
Based on the linked first-party OBS documentation checked on 4 November 2026. The exercises and acceptance checks are editorial workflows for you to run; no hands-on OBS session or hardware benchmark is claimed.
- OBS — macOS Screen Capture Source ↗Checked 2026-11-04
- OBS — macOS Permissions Guide ↗Checked 2026-11-04
- OBS — macOS Desktop Audio Capture Guide ↗Checked 2026-11-04
Spotted something out of date? Let Alex know.
How we put our guides together ↗