Collections

Overview

As your library grows across different events, subjects, or campaigns, you may not want Onset Engine to pull clips from your entire database. Collections allow you to create named groups of source videos and restrict the engine to only use clips from those specific files.

The underlying model and operations for Collections are defined in library_db.py and implemented via the Collection Manager dialog in vibe_gui.py.

Managing Collections

You can manage your collections via the Manage… button found under the Configuration section of the GUI.

Creating a Collection

1. Open the Source Collection Manager dialog.
2. In the “New Collection” section, type a name (e.g., “Summer Campaign” or “Nature Footage”).
3. Click + Create.

Assigning Source Videos

1. In the Collection Manager, locate your newly created collection under “Existing Collections”.
2. Click + Add Sources. This opens a picker displaying all previously ingested videos.
3. Select the videos you want to include in this collection.
4. Click Add Selected.

(Note: Collections are non-destructive. A single source video can belong to multiple collections, and deleting a collection does not delete the underlying clips from your library.)

Rendering from a Collection

To force the engine to only use footage from a specific collection:

1. Go to the Configuration section in the main GUI Inspector tab.
2. Find the Source Collection dropdown.
3. Select your desired collection (e.g., “Summer Campaign”).

When you generate a timeline, Onset Engine will restrict its clip pool solely to the source videos assigned to that collection. If you leave the dropdown set to All (No Filter), it will pull from your entire ingested library.