Libraries & Reusable Settings

Asset Library

The Media Library is a single, read-only view of all your media, grouped by production. Everything you upload to a production and everything the AI generates — scene backgrounds, background videos, music, voiceovers, thumbnails and the final rendered video — appears here automatically, with no manual import step.

Open it from the sidebar Media entry, or directly at /app/media-library. Assets are managed on their production: they appear here when a production runs and are removed when the production is deleted.

What it stores

Asset type	Examples
Logo	Brand logo PNG/SVG
Background Music	Royalty-free or licensed tracks
Intro Template	Pre-made intro animations
Outro	Standard sign-off footage
Transition	Wipes, swipes, custom transitions
Font	Uploaded font files
Image	Photos, illustrations, screenshots
Video	B-roll, demo recordings, stock clips
Voiceover	Saved narration audio
Other	Anything else (PDFs, JSON, CSV)

The Asset Library accepts a broader set of media types than the wizard's upload zone — including audio and video — because assets here are meant to be reused across many productions. Exact per-type size caps and total quota depend on your plan; see the storage panel at the top of the library page for your current usage and limit.

Note: the Create Wizard's Input Media drop zone is stricter than the library — it only accepts images (10 MB each) and documents (5 MB each), with a 200 MB total cap. To use audio in a production, save it to the Asset Library first, then pick it from the wizard's From Library button.

Browsing

The library page header shows a storage bar with usage / limit / percentage. Below it are three controls:

Search — by asset name (debounced — start typing, results filter live).
Filter by type — dropdown of the asset-type categories above.
Filter by source — Uploaded (you added it to a production) · Generated (AI made it during a production) · Rendered (final video files).
Group by — Production (the default) · Asset Type · Source · Size Range · No Grouping. Grouping by production keeps each video's final render, generated scene assets, music, voiceover and thumbnails together under one heading.
View — List is the default (lightweight — icons only, no thumbnails fetched). Switch to Grid to see image thumbnails (loaded lazily as you scroll).

Each asset appears as a card / row showing:

Thumbnail preview in grid view (or a file-type icon)
Name and the production it came from (e.g. from VID-00123)
Type badge · file size · source badge

Click an asset to open a read-only preview (image / audio / video player, plus metadata).

Uploading

The upload form has:

A drag-and-drop zone (or click to browse).
Asset name — defaults from the filename.
Type — one of the type categories.
Media type — auto-detected, editable.
Scene hint (optional) — a hint about which scenes this asset is meant for.
Description — free text for your own reference.

Upload progress is shown inline; the asset appears in the grid as soon as the upload completes.

Asset detail view

Clicking an asset opens its full preview. You can:

Edit name, type, media type, description, and scene hint.
Toggle Must Include — when this asset is referenced in a production, the AI is required to use it (vs. treating it as optional).
Toggle AI Enhance — runs background removal, upscaling, or cleanup on the asset.
Add AI Enhancement Instructions — free text ("Remove white background, upscale 2×").
See metadata: filename, file size, MIME type, source, usage count, created date.
Trash the asset (or Restore it if it's already in trash).

Bulk operations

Toggle multi-select mode and you get a bulk-action bar with:

A selection counter
Bulk Trash — moves all selected assets to the trash

Bulk-edit-metadata is not currently exposed.

Assets appear automatically

There is no manual import step. As each production runs, its generated assets, uploads and final video appear in the Media Library automatically under that production's heading, and all of them count toward your storage. Deleting a production removes its assets from here and from storage.

The Trash

The library has a collapsible Trash section at the bottom showing:

Total item count
Total size of trashed items
Per-item days remaining countdown
Restore and Permanent Delete buttons per item

Heads up — Trash counts against your storage. A 500 MB asset in Trash still consumes 500 MB of your plan's storage allowance until it's permanently deleted. Auto-purge runs every 20 days (cron-based), but if you're tight on storage, empty Trash manually.

Real scenarios

Scenario A — One-time setup, lifetime payoff

A new user spends 10 minutes the first day:

Uploads their logo (PNG with transparency), tagged as Logo type, Must Include on.
Uploads three royalty-free background music tracks (one per mood they typically use).
Uploads a standard outro — a 5-second clip with their channel branding.

Every production from then on auto-incorporates the logo, has music to choose from, and uses the same outro consistently. They don't touch the library for weeks.

Scenario B — Cleanup before a big batch

Before kicking off 10 multi-language variants, the user notices their storage bar is at 92%. They:

Filter by source = Generated and group by Size Range.
Bulk-select images from old, already-published productions.
Move to Trash, then Empty Trash.
Storage drops to 41%. Phase 1 storage check passes for the new batch.

Scenario C — Reusing a guest voiceover

A pre-recorded interview clip will appear in 4 different videos this month.

Upload the MP3 once, type = Voiceover, with a clear name (SmithInterview_30s.mp3).
In each new production, in the wizard's Media block, click Pick from Asset Library and select the file.
Set scene hint per use ("Scene 3").

The clip is referenced by ID; uploading it once doesn't create four copies.

Tips & gotchas

Everything counts toward storage. The storage bar and your plan quota include final videos, every generated scene asset, and your uploads — grouped by production so you can see which videos consume the most space. Delete an old production to reclaim its storage.
Generated assets live with their production. They appear in the library grouped under the production that produced them; there is no separate copy to manage.
Logos with transparency render best. A logo on a white background will look like a white box on a coloured scene.
Search is by name only. It doesn't search descriptions, scene hints, or content. Name your assets descriptively.
Storage runs on dual backends. Your filestore handles small/recent files; an S3-compatible object store (Spaces / MinIO / AWS S3) handles bulk. As an end user you don't see this distinction — usage is reported as a single total.