start_app_window_recording
Record only the visible front-window region of a macOS app for debugging. Validates window visibility and supports manual-stop or timed recording.
Instructions
Start recording only the visible front-window region of a macOS app.
This is the first choice for Chrome, Safari, and desktop-app debugging. It
activates app_name, verifies the front window meets min_visible_ratio, then
records only that visible region via screencapture -R instead of recording
the full desktop.
Omit duration_seconds for the preferred manual-stop workflow, then call
stop_recording with the returned session_id. Options are forwarded to the
macOS backend after region is injected.
If visibility validation fails, the response is {"error": ..., "window": ...}
so the client can reposition or unminimize the target and retry.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app_name | Yes | Exact macOS application name (e.g. 'Google Chrome'). | |
| duration_seconds | No | Seconds to record. Omit for manual-stop workflow. | |
| output_path | No | Absolute path. When omitted, defaults to default_output_root()/video_capture_<app_name>_window.mov. | |
| padding | No | Pixels added to the window region. Default 0. | |
| min_visible_ratio | No | Minimum visible_ratio. 0.0-1.0, default 0.8. | |
| options | No | Forwarded to macOS backend (after region injection). Same keys as start_recording.options minus region. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||