Skip to content

Agent Mode

Agent Mode turns the panel into a 24/7 render worker. It keeps watching your connected data for rows whose status column is ready, renders them one at a time, and writes the result back into the row. Anyone who can edit the sheet can queue renders.

The agent is not tied to one sheet or one job. Connect the data of several unrelated projects at once, and one panel on one machine renders all of them, whichever job a ready row comes from.

Connect as many files, worksheets or views as you need: the agent watches every one of them. Each source is a job of its own:

  • Its own columns. Every source is read with its own header row, so a soda campaign and a gym’s social clips can use completely different columns in the same agent session.
  • Its own project. A project column points each row at its .aep. The agent opens the right project for every row it picks up, whatever source it came from. Switching closes the open project without saving, so save your work before starting the agent.
  • Its own output. render-settings and output-module columns give each job its own format, for example ProRes for one client and H.264 for another.
  • Its own team. Whoever can edit a source can queue renders in it. Each team works in its own sheet and never sees the other jobs.

For example, two worksheets connected to the same agent:

Tint soda ads

project comp output flavor status
D:\Tint\ads.aep Ad-9x16 tint/orange_es Blood Orange ready

Gym class promos

project comp output coach status
D:\Gym\promo.aep Promo-1x1 gym/spin_mon Ana ready

The agent renders both rows, each in its own project, and writes complete back into each sheet.

Output Path, Footage Path and the template dropdowns are shared by every source. Give each job its own subfolder in the output value (tint/..., gym/...) to keep the renders apart, and use full paths or links in footage cells when jobs keep their footage in different places.

All connected sources are of one type: local files, Google Sheets or Airtable. Google Sheets connects up to 10 worksheets.

  1. Connect your data sources: one or many files, worksheets or views.
  2. Set the Output Path and template dropdowns as for a normal render.
  3. Click Run Agent.

The panel with the agent running: the button reads Stop Agent and the status bar names the row being rendered.

Sources higher in the panel’s connection list come first, and within a source, rows are taken from top to bottom. A source further down is only served once no source above it has a ready row, so put your most urgent job at the top of the list. The status bar shows a countdown to the next check for new rows.

Click Stop Agent to stop. A render already in progress finishes first and its row is written back; until then the button reads Stopping….

After Effects must stay open with the panel running: the agent runs inside your panel, on your machine.

status value Meaning
ready You (or your team) set this. The agent will pick the row up.
rendering... Written by the agent when it starts the row.
complete Written on success.
sent to watchfolder Written on success when watchfolder mode is on.
error: <message> Written on failure, with the reason.

In the example above, two rows were marked ready. Afterwards the file reads:

output flavor status
tint_concord-grape_en Concord Grape complete
tint_blood-orange_es Blood Orange complete
tint_blue-raspberry_de Blue Raspberry
  • The status column must exist; sources without it are skipped.
  • Spaces around the word are ignored (ready counts), but capitals are not: Ready is not picked up.
  • Each row is marked before it starts, so it renders once. To render it again, set it back to ready.
  • A failed row gets error: ... and is not retried until you set it back to ready. The agent keeps watching for other rows.
  • With Google Sheets and Airtable, everyone looking at the sheet sees the status change live.
  • With delivery information turned on, the agent also fills in each row’s br- columns.
  • If a status cannot be written (for example, a read-only file), the status bar says so and the agent skips that row until you restart it.

Each source has a few specifics: Local Files (keep the file closed in other editors), Airtable (field types and a self-maintaining queue view). With Airtable, status lines name a record instead of a row number; see Airtable row numbering.