> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arcdemo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Capture a Mac app

> Record a selected native application window with the macOS recorder.

The ArcDemo macOS recorder requires macOS 14 or later. It captures a selected application window as steps, with optional motion, and sends the result to ArcDemo for editing. It records a window rather than the entire display.

## Prepare the window

Open the application and arrange the window before recording. Use a test account and representative data, and make sure the workflow fits within that window. The recorder captures clicks inside the selected source; it does not capture other windows as part of that selection. If a workflow opens another window, review the result carefully and plan a separate capture if needed.

Avoid moving or resizing the selected window during a recording. The recorder checks that the source and its geometry remain valid and may stop safely if the window disappears or changes. If the window is not listed, open it and refresh the capture-source list.

1. Open the recorder and sign in through your browser. Choose the authorized workspace.
2. Grant **Screen Recording** and **Accessibility** permissions when the recorder requests them.
3. Enter a demo title and select the application window under **Capture source**. Refresh the window list if necessary.
4. Select **Start recording** and perform the workflow. Use test data and keep the selected window available during capture.
5. Select **Stop & upload**. Keep the recorder open while the upload completes, then open the demo in ArcDemo and review the steps.

## Review the captured story

The recorder produces click-based screenshots and a final screen, with optional motion between steps. Let the interface settle as you work, then check that the final screen shows the outcome you intended. Use **Pause** and **Resume** when you need to interrupt the recording, and preview the completed steps in the editor for missing actions or awkward transitions.

The recorder does not read typed text or control values as input events, but text displayed in the selected window can still appear in its captured pixels. Check the screens and any motion for private information before publishing. See [Prepare a safe capture](https://docs.arcdemo.io/guides/capture-safely.md).

## Recover an interrupted capture

If recording stops safely, read the message and choose **Check recovery**. When an interrupted local capture is available, the recorder can offer **Recover & finalize** to reconcile and finish it. Follow the prompts, keep the recorder open, and confirm you reach **Demo ready** before opening the result in ArcDemo.

**Cancel draft & discard** is a destructive choice for that recovered capture: the recorder attempts to cancel the remote draft before removing local recovery. Choose **Keep recovery** if you still need the material. If permissions were revoked, restore them and sign in again as prompted before attempting recovery.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.