> For the complete documentation index, see [llms.txt](https://manuscript.knightsoftheeditingtable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manuscript.knightsoftheeditingtable.com/extensions/quiver/main-panel.md).

# Main panel

The Quiver main panel is a file manager for clips library. On the left is the folder tree; on the right is the preview pane with item tiles.

## Active Quiver folder

Active Quiver folder has a blue box near it — shortcuts and Toolbar 1 add items from that folder.\
You can activate Quiver folder by clicking on it or with a shortcut.

[Learn more](/extensions/quiver/export-import.md) about Quiver folders.

<figure><img src="https://270111504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqQuRw1JZNewsp-NrzE%2Fuploads%2FmfP3IoLbFoKqsuffd9RE%2FQuiver_main_select_folder.gif?alt=media&amp;token=9c68558e-1c86-4d32-8a6c-6511c0125077" alt=""><figcaption></figcaption></figure>

## Add clips to Quiver

There are multiple ways to add items to Quiver:

* through context menu (right click)

<figure><img src="https://270111504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqQuRw1JZNewsp-NrzE%2Fuploads%2FoRNKlowJsA7XCxOLZIMl%2FQuiver_add_item_context.png?alt=media&amp;token=46564fe6-f482-4942-a412-1d79f2a0308a" alt=""><figcaption></figcaption></figure>

* with **plus button** at the bottom of the panel
* drag and drop from a file manager or from Project panel

<figure><img src="https://270111504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqQuRw1JZNewsp-NrzE%2Fuploads%2FuyjvBW6Zu5omflZ6cC1v%2FQuiver_drag_n_drop.gif?alt=media&amp;token=46edba07-7f89-49de-97bc-bee290e6db7f" alt=""><figcaption></figcaption></figure>

Depending on the import mode [setting](/extensions/quiver/settings.md), files will be copied to Quiver data folder or will stay at its original path and referenced in Quiver.

{% hint style="info" %}
To toggel between import mode, hold `opt/alt` key during drag and drop.
{% endhint %}

## Add clips to a timeline

It is possible to add Quiver item to a timeline with:

* double click on Quiver item in main panel
* single click on Quiver button in a [toolbar](/extensions/quiver/toolbars.md)
* a shortcut or control surface button assigned to Quiver item in [Spell Book](/extensions/spell-book.md)

<figure><img src="https://270111504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqQuRw1JZNewsp-NrzE%2Fuploads%2FvR1sFSBch2i3XWmQdAaj%2FQuiver_add_clips.gif?alt=media&amp;token=5f00be01-aca5-473c-86a6-edd38331dd68" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
It is possible to add clips to the timeline during live playback.
{% endhint %}

***

## Quiver items

### Item types

<figure><img src="https://270111504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqQuRw1JZNewsp-NrzE%2Fuploads%2FNcupbQFGA7gHTRm1Sugl%2FQuiver_button_types.png?alt=media&amp;token=ed5c18fc-ba78-460a-926e-72d01a2db560" alt=""><figcaption></figcaption></figure>

There are 3 types of buttons in Quiver panel:

<table data-header-hidden><thead><tr><th width="157"></th><th></th></tr></thead><tbody><tr><td><strong>Clip</strong></td><td>Adds one clip associated with a button.</td></tr><tr><td><strong>Folder</strong></td><td>Adds one random clip from a folder. <a href="/extensions/quiver/folder-item.md">Learn more</a>.</td></tr><tr><td><strong>Sequence</strong></td><td>Adds group of clips from a sequence. <a href="/extensions/quiver/sequence-item-group-of-clips.md">Learn more</a>.</td></tr></tbody></table>

### Addition method

To modify add method for clips, right click on it and select a method.

<figure><img src="https://270111504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqQuRw1JZNewsp-NrzE%2Fuploads%2F5V2l2Qbt6xyRvbbLJXD2%2FQuiver_add_method.png?alt=media&amp;token=6fe842bb-2d9a-4b5f-9e67-567267cb9216" alt=""><figcaption></figcaption></figure>

Available methods and their actions are listed below:

<table><thead><tr><th width="155">Method</th><th>Action</th></tr></thead><tbody><tr><td>Overlay</td><td>If targeted track has a clip at playhead, added clip will be added to the first empty track above.</td></tr><tr><td>Overwrite</td><td>Ignores any clip at playhead and overwrites it with a clip.</td></tr><tr><td>Insert*</td><td>Ignores any clip at playhead, inserts a clip and pushes forward all clips on a targeted track.</td></tr></tbody></table>

{% hint style="warning" %}
**\*Insert** method is not available for MOGRT items, due to API limitation.
{% endhint %}

### Target track

By default clips will be added to the bottom targeted track.

You can change it for each item and specify destination track by its name.

<figure><img src="https://270111504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqQuRw1JZNewsp-NrzE%2Fuploads%2FC0rmBM44ZHPXUi3sMX0p%2FQuiver_track_target.png?alt=media&amp;token=1322169d-d6c6-42c9-91de-ca3bf182dc1f" alt=""><figcaption></figcaption></figure>

#### Creation of tracks

If a clip targets a track with a name and such track doesn't exist, track will be created.

If a clip uses "**Overlay**" method and a track with name is occupied, new track with incremented name will be created (e.g. "**Sword 2**" is occupied, "**Sword 3**" will be created).

### Label

Change label of an item added to a timeline.

<figure><img src="https://270111504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqQuRw1JZNewsp-NrzE%2Fuploads%2FfGeGwDG3VA2GaYTNHTmV%2FQuiver_label.png?alt=media&amp;token=85051dc3-6864-4df1-82d1-57e6a86aaf86" alt=""><figcaption></figcaption></figure>

### Blend mode

For video items you can customise blend mode. It is useful for overlays.

<figure><img src="https://270111504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqQuRw1JZNewsp-NrzE%2Fuploads%2Fu2F86r3e0RG0LwfOHNKS%2FQuiver_blend_mode.png?alt=media&amp;token=e7f1f39d-d0a9-4c44-99cc-0f4d9117e8fc" alt=""><figcaption></figcaption></figure>

### Volume

For audio items set volume when it is added to a timeline.

<figure><img src="https://270111504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqQuRw1JZNewsp-NrzE%2Fuploads%2FKP9RaZaeQCnW7fgly6QB%2FQuiver_item_volume.gif?alt=media&amp;token=a2d1071f-e804-42eb-b81a-6951a1010a6a" alt=""><figcaption></figcaption></figure>

### Duration

For still images set duration when it is added to a timeline.

<figure><img src="https://270111504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqQuRw1JZNewsp-NrzE%2Fuploads%2FLXzN4XpbvJSmDEJOytxH%2FQuiver_duration.gif?alt=media&amp;token=f918719d-23bf-4fe4-9281-58a5e372e640" alt=""><figcaption></figcaption></figure>

### Start Marker

By default clips are added at playhead at their in point.

If a clip has start marker, when added to a timeline, start marker will be aligned with playhead.

<figure><img src="https://270111504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqQuRw1JZNewsp-NrzE%2Fuploads%2FyBK1vEY5elSm8buLSH2C%2FQuiver_start_marker.gif?alt=media&amp;token=70f43150-3f44-4cb5-be25-74df6e9d224d" alt=""><figcaption></figcaption></figure>

If [Auto-mark audio clips](/extensions/quiver/settings.md#auto-mark-audio-clips) is enabled, start marker will be added automatically, when audio clips are added to Quiver, at the loudest part.

### In/Out points

You can set in/out point to a clip, so only part of it will be added to a timeline.

<figure><img src="https://270111504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqQuRw1JZNewsp-NrzE%2Fuploads%2FUho9yapG9RZ8szTdATpL%2FQuiver_in_out.gif?alt=media&amp;token=ce39a84a-b780-4c88-afba-2dda9d8b375e" alt=""><figcaption></figcaption></figure>