# How it works

## Create Sequences

To create sequences, drag and drop clips from Project panel to Cauldron timeline.\
Adjust settings if needed and press "Brew Sequences" button.

<figure><img src="/files/QpYUQqcRE2rdLRVyCjWh" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/wywN814Ir1504eaA4mtv" alt=""><figcaption></figcaption></figure>

* It is possible to add one clip or group of clips.
* It is possible to combine any amount of clips on video and audio tracks, but only 1 clip is allowed per caption track.

In/Out points of source clips will be used.

{% hint style="info" %}
If clip duration inside sequence needs to be adjusted — change clip in/out point or duration and re-generate sequences again.
{% endhint %}

### Group of clips

When group of clips is added, Cauldron will iterate over each clip inside the group and create all possible combinations of sequences.

It is possible either to select group of clips or just bin with clips inside, it will also act as a group.

{% hint style="info" %}
When a bin is added to Cauldron, you can add/remove clips from it and generate updated version of sequences.
{% endhint %}

#### Ungroup clips

To ungroup added clips, right click on a group and select "Ungroup".

<figure><img src="/files/USQfq9cfl311DN0CbpTM" alt=""><figcaption></figcaption></figure>

### Trim clips

It is possible to trim clips before adding them to generated sequences.

To do this, right click on a clip and select "Trim clip".

<figure><img src="/files/mDuIClD9WVjOwdyN4zVF" alt=""><figcaption></figcaption></figure>

### Remove clips

To remove clips from Cauldron, right click on a clip and select "Delete".

If you want to remove all clips, use "Empty Cauldron" button.

## Sequence Settings

### Sequence name

Cauldron creates multiple sequences, so it is good to have name that reflects what is inside of a sequence. Wildcards allow to create dynamic names for sequences.

<table><thead><tr><th width="202">Wildcard</th><th>Description</th></tr></thead><tbody><tr><td><strong>#V1{1}</strong></td><td>use name of 1 clip on the first video track</td></tr><tr><td><strong>#A2{3}</strong></td><td>use name of 3 clip on the second audio track</td></tr><tr><td><strong>#C1</strong></td><td>use name of caption clip on the first audio track</td></tr><tr><td><strong>#VER</strong></td><td>version of a sequence</td></tr></tbody></table>

### Width, Height, FPS

Disable `Match first video clip` checkbox to set custom width, height and fps for created sequences.

### Auto-reframe

Use Premiere's "Auto-reframe sequence" feature.

### Clip Sizing

3 options availble:

* None — clips size stays unchanged
* Fill Frame — clip will fill the frame of a sequence (crop might occur)
* Fit Frame — clip will fit the frame of a sequence vertically or horizontally


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://manuscript.knightsoftheeditingtable.com/extensions/cauldron/how-it-works.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
