Writing Scrambo Programs
How a Python program directs Scrambo's team of video-editing agents.
Scrambo lets a Python program direct a team of video-editing agents. Your program supplies the creative intent, passes work between specialists, and decides what must be validated. Scrambo inspects the real media and builds the timeline in a browser editor.
Most programs use five facades:
from scrambo import editor, planner, source, timeline, validationeditorowns the editing session and browser editor.sourceunderstands, prepares, or generates media.planneranswers read-only editorial questions and compiles grounded edit plans.timelineauthors, refines, and validates the edit.validationchecks source, plan, or timeline artifacts with only the validators applicable to that artifact.
Some steps also use tools — optional capabilities you import from
scrambo.tools and grant to a specialist for a single call. For example,
transcribe lets an agent read the spoken words in your media, detect_events
lets it watch a clip and mark what happens, detect_beats lets Source Work find
the rhythm of a track, masking prepares or places a paid subject matte, and
the generation tools img2video and voiceover create new footage or
narration. Sound effects are built into timeline.sound_agent rather than
exposed as a separate public tool.
Tools are opt-in and covered in detail later; the idea to hold onto now is that
a specialist can use a tool only when you explicitly give it one.
A Scrambo program is the Python script you write. Scrambo may generate its own low-level editing code while carrying out your requests, but that is an implementation detail; you do not write or manage it.
This guide focuses on the API and on composing agents. Install the SDK and sign in once (below) before running your first program.