Puffin Ship Docs

av_recorder

Pauses the run and asks you to record a take in the browser, then puts that recording on the timeline for later steps to work with.

When to use

Use av_recorder when a video needs you on camera and you would rather record to the script than film separately and upload. The run waits at this step until you record a take (or upload a file) and accept it.

Give it a script input and you get a teleprompter during the take, plus a short shot direction describing what this take should be. Without a script, you get a freeform recording.

For a walkthrough of the recording screen itself, see Recording in the browser.

In the editor

Add it from the Library (Recording group), or with + add step and a search for av_recorder, wherever the footage of you belongs in the pipeline.

There is nothing you must fill in. Under Inputs, add script as a step input pointing at your script step (or a file input naming a text file) if you want a teleprompter and a shot direction during the take; leave it out and you get a plain recording. rotation is for phones and cameras that record sideways: setting it here means a re-run keeps the same rotation without asking you again.

When the run reaches this step it stops and waits, showing awaiting recording, and the recording panel opens. Take as long as you like; nothing is running while it waits. Record, watch it back, and accept it with Use this take.

The take then appears as a clip on the level you chose, and behaves like any other footage: later steps can transcribe it, cut it, caption it, and lay b-roll over it. It is kept, so re-running the template reuses your take rather than asking again. To do it over, use the ↩ control on the step in the run view.

YAML Example

- id: record_intro
  processor: av_recorder
  input:
    - id: script
      step: write_intro   # optional: any step that produces a script
  params:
    rotation: 90          # optional: 90, 180, or 270
  output:
    timeline: main

Inputs

ID Source Required Description
script step or file no Script text shown on the teleprompter and used to write the shot direction. A write_script step or a text file both work.

Params

Param Type Default Description
rotation select: 0, 90, 180, 270 "0" Clockwise rotation to apply to the recording in degrees. Valid values: 90, 180, 270. When set, this overrides the rotation you choose on the recording screen, so re-runs use the same rotation without needing a new take. Changing it makes the step run again.

Output

EditDecisions: one clip covering the whole recording, on the configured level.

Behavior

  1. If a script is wired in, its text is read and shown on the teleprompter.
  2. A one or two sentence shot direction is written from the script. Without a script, or without an AI backend, you get the default direction: "Record yourself reading the script to camera. Speak naturally."
  3. The run pauses with the status awaiting recording and opens the recording panel. It waits as long as you need.
  4. You record a take (or upload a file you recorded elsewhere), review it, and accept it with Use this take.
  5. The take is prepared for editing, rotated if you asked for rotation, and placed on the timeline.

Notes

  • The step works with or without an AI backend. Without one you still get the teleprompter and the default shot direction.
  • The script input is optional; the step has no required inputs.
  • Once a take is accepted the step is done, and re-running the pipeline reuses it. To record again, use the ↩ control on the step in the run view.
  • Your recording is an ordinary clip, so later steps can transcribe it, cut it, caption it, and lay b-roll over it.