The watch folder (headless job specs) — Automation — VidVertex Docs
Docs/Automation/The watch folder (headless job specs)

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.