Record a desktop app
Record a Mac app's window with vos record --app, by hand or from a click path.
Record a Mac app's window with vos record --app, by hand or from a click path.
Record a Mac app's window with vos record --app, the same way the CLI
records a page.
vos record --app "Calculator" --out takeUse the app while it records, then press Ctrl-C. The window is recorded alone, without the system pointer, and the pointer's path is saved beside it. A take is a recording plus its cursor track and edits, so the studio draws the cursor and plans zooms as it does for a page.
Give it the same click path a page uses. A selector names a control by its role and what it is called.
vos look --app "Calculator"
vos record --app "Calculator" --actions actions.json --out take --strictvos look lists every control with one selector, such as
button[id='Seven']. A scripted take presses the real app with your pointer
and keyboard, so leave the machine alone until it ends. It stops at the
first step that misses.
Start a second copy of the app with its own profile and a scratch project,
and record that one by its process. vos record --windows lists each
window's process, and --pid picks it. An Electron app such as VS Code
needs --force-renderer-accessibility when it starts, or vos look finds
no controls.
A game needs a program, not a list of steps:
vos record --app "Google Chrome" --play play.mjs --out takeexport default async function (play, { window }) {
await play.step('start', () => play.click("button[name='Play']"))
await play.step('fly', async () => {
// look, decide, act, as often as it takes
await play.move(window.w / 2, window.h / 2, 12)
}, { zoom: false })
}zoom: false marks play: no zoom is proposed there.
When the app is your account, keep what is yours out of the picture with
mask:
"mask": [{ "selector": "popup[name*='Account']" }]Every match is covered before a frame is saved, so it is in no file. Have
it on screen before the take begins. A script that types into the app can
undo it with teardown, off camera.
This needs macOS 14 or later, with Screen Recording granted to the app your
terminal runs in, and Accessibility for a scripted take. vos doctor says
which are granted. Every flag is on Verbs, and the click
path's format on actions.json.