Seconds
RequiredWhole numberHow long to record.
Minimum: 1
Default: 5
5
Record the Mac's screen for some seconds, as a file.
First, connect Mac in Services. Then open Actions → + → Mac and choose Capture Screen Video.
Records the whole screen and hands the video to Shortcuts as the result's File. Needs the Screen Recording permission. Shortcuts gives an action about half a minute, so keep recordings short when run from a shortcut.
Open an input to choose its value. Keep a fixed value with Text, receive it from Shortcuts, ask when the action runs, or use an Earlier Step. Read how input sources work.
How long to record.
Minimum: 1
Default: 5
5
This action brings a file back. Shortcuts receives it as the result’s File, whatever you choose below. Shortcuts shows the result as text by default, which for a file is only its name and size: tap the Execute Action result where you use it and choose File.
In the action editor, open Output → Returned Value to choose fields for your shortcut. These are the response fields described by the app; a service may omit an optional field or return an empty list. JSON File contains the full response.
| Returned field | Type | Meaning |
|---|---|---|
name | string | The recording's file name, with the date and time it was made. |
size | integer | In bytes. |
seconds | integer | How long it was asked to record. |
If the result is unexpected, open Logs in Shortcutify, select the run, and inspect this step’s inputs and response.
On the computer: screencapture -v, over a signed-in SSH session. No web request is made.
Action identifier: mac.screen-video.v1
No additional per-action permissions are declared in the app’s catalog. The integration’s connection and account access rules still apply.
| Input | Key |
|---|---|
| Seconds | seconds |