> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Reference videos

> Import a video you want to learn from, analyse its pacing, text and sound, and turn it into a blueprint and a project skeleton.

A reference video is a video whose style you want to learn from, such as a competitor's clip or a trend. CoClip keeps your references in one library, analyses them on your computer, and turns the analysis into a blueprint you can build your own video from.

## 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](/docs/interface/start-screen.md).

The view opens over the whole window and works without a project open. Press `Esc` or click **Close (Esc)** to return.

Screenshot coming soon

Reference videos library
State: Several reference cards, a link download in progress
Highlight: Video link box, Import link… and Import video… buttons

## Add a reference

> [tab] From a file
>
> **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.
>
> To keep only part of a long file, click **Import part of a file…**, pick one video, set **Start** and **End**, then click **Import**.

> [tab] From a link
>
> **1. Paste the link**
>
> Paste a video link (TikTok, YouTube, Instagram and similar) into the link box and click **Import link…**.
>
> **2. Choose the part**
>
> CoClip reads the link and shows its length. Set **Start** and **End** to keep only part of it. A part can be at most 10 minutes.
>
> **3. Download**
>
> Click **Download and import**. Click **Hide** to keep working: the download keeps running and stays listed in the library.

The reference appears as a card in the library. A video that is already there is not added twice.

Some links need you to be signed in. Turn on **Use browser login** in **Settings** → **Video downloader** and choose your browser. CoClip never stores the browser's cookies or shares them with your agent. See [Settings](/docs/reference/settings.md). If a link import fails, see [Troubleshooting](/docs/reference/troubleshooting.md).

## 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.

When it finishes, you see:

* **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.

For a closer look at movement, click **Deep motion**. It studies the video frame by frame and adds motion lanes. **Delete motion data** removes it again and keeps the analysis.

Screenshot coming soon

Reference detail, Analysis tab
State: Analysed reference with metrics, lanes and key images
Highlight: Speech menu, Analyse button and lanes

## 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**.

A new project opens, or new tracks appear in the open project from the start of the timeline. Nothing already in the project changes, and one undo removes the whole skeleton. A message lists anything still to make.

Without a font in the project, only markers and empty tracks are created. Import a font first to get text styles and placeholder texts.

## Related

* [Script](/docs/library/script.md): write and approve the clip script.
* [Example prompts](/docs/ai-agents/example-prompts.md): ask your agent to study a reference and write a script.
* [Connectors](/docs/reference/connectors.md): add an ElevenLabs key for Scribe.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.