Virtual.ink documentation

Library is the high-density browser and dataset manager in the Media module. Use it when you need to scan the full gallery, compare many datasets quickly, or run file-management actions on one or more datasets.

What You See On Each Card

Each dataset appears as a card in a configurable grid. A card can show:

• the dataset thumbnail
• an MP4 badge when a video file exists
• a snapshot count badge when extracted frames exist
• the dataset folder name
• relative time based on the timestamp-style folder name
• a processing overlay when renders are still queued or running

If a dataset has no thumbnail yet, Library falls back to a film icon placeholder.

Opening The Detail Modal

Click any dataset card to open the detail modal.

Inside the modal, Library can show:

• the absolute timestamp for the dataset
• the dataset position inside the current list
• auto-playing muted video when a video file exists
• a snapshot picker and a larger snapshot preview when frames exist
• a thumbnail-only preview when there is no video but a thumbnail exists

The detail modal is for quick inspection. It does not currently jump to the Player page.

Detail Modal Controls

• Previous and Next buttons move through the current Library list.
• Escape closes the modal.
• Left Arrow and Right Arrow also move between datasets while the modal is open.
• The close button dismisses the modal immediately.

Selecting Datasets

Library supports a dedicated selection mode for batch operations.

You can enter selection mode by:

• clicking the selection circle in the top-left of a card
• opening the dataset menu and choosing Select

Once selection mode is active, Library shows a bottom action bar with:

• selected count
• Select all
• Clear
• Cancel
• Actions

Bulk Actions

The bulk Actions menu currently includes:

• Move
• Copy
• Archive

Bulk delete is not exposed in the current action bar. Delete remains a per-dataset action from the dataset menu.

Per-Dataset Menu Actions

Each card has a dataset actions menu in the top-right corner. Depending on the environment, it provides:

• Open containing folder or Copy folder path
• Select
• Move
• Copy
• Archive
• Delete

When the desktop bridge can open folders directly, Library opens the dataset folder in the operating system. Otherwise it copies the dataset path to the clipboard.

Move And Copy Dialog

Move and Copy open the transfer dialog.

The dialog includes:

• the operation type
• the number of selected datasets
• a destination path field
• a Browse... button when the desktop bridge exposes folder picking
• Confirm and Cancel

Enter a valid destination path before confirming. For move operations, datasets leave the current gallery location after the transfer succeeds.

Keyboard Shortcuts

• Ctrl+, opens or closes Library settings.
• Escape closes the transfer dialog first, then the bulk action menu, then selection mode.

In the current page implementation, Library settings are keyboard-opened only.

Library Settings

Library uses the shared preset editor in its settings modal. That modal lets you:

• choose the active preset
• create a new preset
• rename the current preset
• delete a non-default preset
• copy the preset URL
• open the preset URL in a browser

The current Library preset fields are:

• Columns: grid density from 1 to 12 columns
• Order: ascending or descending by dataset name
• Filter: reserved in the current build and does not change the list yet

Because dataset names are timestamp-based in normal operation, descending order is usually the newest-first view operators expect.

When To Use Library

Use Library when you need:

• the fastest way to scan many datasets
• dataset-level housekeeping and batch operations
• folder access or path copying
• a quick preview modal without leaving the gallery grid

If you already know which dataset you want and need a focused decision view, move to Quickview. If you want uninterrupted playback, use Player.