Collection Management

Media Collection Management

Media collections are managed primarily via the DRES CLI. Admin users can also fully manage collections and individual media items — not just browse — from the web UI (create/edit/delete collections and items). Note the web UI's collection-list component is currently marked deprecated in source, so this area may be reworked in future releases.

Media items are one of three types: IMAGE, VIDEO, or TEXT (the latter used for e.g. LSC Q&A-style tasks).

Getting Started

Step 1 — Create the collection

DRES> collection create -n NAME -d DESCRIPTION -p PATH

Argument	Description
NAME	Human-readable name for the collection. Must be unique system-wide.
DESCRIPTION	Optional description of the collection.
PATH	Path to the root folder containing the media files.

Step 2 — Scan and import media items

DRES> collection scan -c NAME -vt mp4 -it jpg

This scans the collection's root folder for matching files:

• -vt specifies video file extensions (e.g. mp4)
• -it specifies image file extensions (e.g. jpg, png)

Both flags can be used together for mixed collections.

Step 3 — Import video segments (videos only)

The submission system expects segment information for video items. Import segments from a CSV file:

DRES> collection importSegments -c NAME --input FILE

FILE is the path to a CSV file with the following format:

video,name,start,end

Column	Description
video	Filename of the video item as found during the scan
name	Name for this segment
start	Start of the segment, in milliseconds
end	End of the segment, in milliseconds

Values are stored as given, with no frame-to-time conversion — make sure your CSV is already in milliseconds, not frame numbers.

This step is not required for image-only collections.

Other CLI Subcommands

Beyond create, scan, and importSegments, the collection command also supports:

Subcommand	Description
collection list	List all collections
collection show	Show details of a collection
collection update	Update a collection's metadata
collection delete	Delete a collection
collection check	Check a collection for missing/broken media files
collection add -t -p -d -f	Add a single media item (-t type, -p path, -d duration, -f fps)
collection deleteItem	Delete a single media item
collection export / collection import	Bulk export/import of media items (distinct from importSegments, which only handles segment metadata)

Use -h on any subcommand for its specific options.