Open Reference videos
- In the editor, click the Reference videos button in the header.
- On the Start screen, click Reference videos… at the bottom. See Start screen.
Esc or click Close (Esc) to return.
Add a reference
- From a file
- From a link
1
Import
Click Import video… and choose
.mp4, .mov, .webm or .mkv files. You can also drop the files onto the library.2
Wait for the copy
A message stays up while CoClip copies the video into the reference library.
Analyse a reference
1
Open the reference
Click its card. The Analysis tab opens.
2
Choose how to read speech
In Speech, pick Local (Whisper, on this PC), or ElevenLabs Scribe (uploads audio) if you have an ElevenLabs key. Turn On-screen text on to read the text in the video.
3
Run the analysis
Click Analyse. You can cancel while it runs. ElevenLabs may ask you to confirm the cost first.
- Metrics: duration, size, number of shots and cuts per 10 seconds, median shot length, words per minute, speech ratio, loudness, tempo and how much of the time text is on screen.
- Lanes on one time axis: shots, on-screen text, speech and words per minute, audio with silences and beats, and key frames. Click a lane to jump to that moment.
- Key images: candidate frames. Click the star to keep one, Add frame at playhead to add your own, Export… to save the images, or Add to current project to put them in your project’s Library.
Edit the blueprint
The Blueprint tab describes the reference as a recipe: Overview, Segments, Text & captions, Style, Motion, Audio and Key images. CoClip drafts it from the analysis.- A new blueprint shows Draft. Edit the sections and click Save draft, or Discard your changes.
- After the first save, click Save to keep changes.
- Your agent can edit the blueprint at the same time. If it changes, CoClip reloads it and keeps your unsaved changes on top.
Create a project from the blueprint
1
Open the dialog
In the Blueprint tab, click Create project from blueprint….
2
Choose where
Under Into, pick A new project (set Name, Location, Canvas and Frame rate) or The open project.
3
Choose the mode
- Generic: tracks, markers and placeholder texts that follow the reference’s structure.
- Thread story: one card per title text or segment, when the blueprint has them.
- From the clip script: a marker and a text in the reference’s style for each beat of the open project’s approved script.
4
Pick options and create
Choose options such as Import key images and a Font. Click Create project or Add to project.
Related
- Script: write and approve the clip script.
- Example prompts: ask your agent to study a reference and write a script.
- Connectors: add an ElevenLabs key for Scribe.

