The watch folder (headless job specs)
For scheduled, fully unattended operation there's a second folder mechanism:
drop a job spec file (a small JSON/YAML step list: render these stacks,
upload with these settings, run this assembly preset) into the watch folder and
the headless watcher picks it up, executes it, and files the spec into
done/ or failed/ with a machine-readable result.
- Start it with
VidVertex.exe --cli watch(e.g. via Task Scheduler at night). - A job file can't approve its own posting in the API modes — a file dropped into a folder is precisely the caller no human checked. It posts what the review queue approved.
- Metricool runs need Google Drive connected beforehand: the watcher never opens the sign-in window either.
- Results include everything a human or script needs to audit the run.
WARNING
Keep the watch folder on a local disk. A shared or cloud-synced folder means another machine can drop a spec — or the sync can replay one.