Bundles

A bundle is the main container Vidsy.ai uses for recorded video work.

Usage

Instead of treating every recording as a separate job, Vidsy.ai lets you group related recordings in one bundle. You can use a bundle to organize footage, analyze it, and review the results together.

Use bundles when you want to:

• analyze a single inspection video
• keep several related recordings together
• record directly into a project instead of saving loose video files
• review multiple videos from the same run or work context

What a bundle contains

A bundle can contain:

• one or more recordings
• the analysis results generated for those recordings
• playback state for review

info

New recordings are saved into the project's recordings folder and added to the currently selected bundle.

Create a bundle

There are two main ways to start using bundles.

Create an empty bundle

In videos mode, click the + button next to recording bundles.

This creates a new empty bundle so you can:

• drag video files onto it
• use the bundle menu to add files
• select it first and then record directly into it

Record straight into a bundle

When you start recording, Vidsy.ai opens a dialog before recording begins.

In that dialog you can:

• enter the recording file name
• save into an existing bundle
• create a new bundle for the recording

If a bundle is already active, Vidsy.ai proposes that bundle by default. New bundle names follow the bundle N pattern, and recording names follow the recording N pattern when possible.

Adding files to a bundle

After a bundle exists, you can add videos in two ways:

• drag supported video files onto the bundle
• open the bundle menu and choose Add file

Supported recording imports include:

• .mp4
• .webm
• .mpg
• .mpeg

When you add MPEG files, Vidsy.ai converts them to MP4 automatically so they can be played and analyzed in the normal recording workflow.

Work with a bundle

Once a bundle has recordings in it, you can use it as the workspace for recorded analysis and review.

Analyze or re-analyze the bundle

Select the bundle and press Analyze, or use (Re-)Analyze from the bundle menu.

You can also right-click any recording in the bundle and choose (Re-)Analyze from the recording context menu. When you start analysis this way, the bundle card shows the active analysis state and the stop button, just as if you had started it from the bundle menu.

This lets you:

• process newly added footage
• re-run analysis after model or threshold changes
• analyze all recordings or only selected recordings when that option is available

Review recordings and events

After analysis, a bundle is reviewed as a set of recordings. You can switch between a multi video view and a single recording tab.

In multi video view, you can:

• scan the recordings in the bundle as a list
• select one or more recordings
• review events and overlays for the selected recordings
• jump to event positions during analysis or after it finishes

In single tab view, you focus on one recording at a time while keeping the rest of the bundle available for navigation.

Control playback in multi video view

In multi video view, Synchronized play controls how playback controls behave for the visible recordings.

• When synchronized play is on, one video control drives all selected recordings together.
• When synchronized play is off, each recording has its own video control.

Use synchronized play when the selected recordings belong to the same time window. Leave it off when you want to inspect recordings independently.

Bundle card status

Each bundle card shows a compact status line that reflects how much of the bundle has been analyzed:

Status	Meaning
Not yet analyzed	No recordings in the bundle have been analyzed yet.
Partially analyzed	Some recordings have been analyzed, but at least one has not.
Fully analyzed	All recordings in the bundle have been analyzed.

When at least one recording has been analyzed, the card also shows a Last analyzed timestamp — the most recent time any file in the bundle completed analysis. This timestamp updates after each file finishes, so it is visible even when a bundle is only partially analyzed.

The bundle creation date is still available — hover over the status line to see it as a tooltip.

While analysis is actively running, the card shows live analysis progress instead of the status line. The progress display includes the total duration being processed and the remaining duration for the current run. The status updates automatically when analysis finishes, without reloading the app.

Bundle management

Each bundle card supports a small set of management actions.

You can:

• rename the bundle directly from the bundle card
• add files
• start or stop analysis
• toggle Synchronized play
• delete the bundle

Deleting recordings from a bundle, or deleting the whole bundle, also removes the related analysis data for those recordings.

Advanced bundle actions

Some bundle actions depend on the active project and runtime.

Compare with reference data

Some projects let you compare a bundle against a manual inspection reference file (CAMI JSON or BEFDSS XML). The comparison overlays color-coded status indicators on the events list and dashboard so you can focus review time on discrepancies — where the AI found something the inspector missed, or vice versa.

See Comparing bundles against reference data for the full workflow.

When to use one bundle vs multiple bundles

Use one bundle when the recordings belong to the same inspection run or should be reviewed together.

Use multiple bundles when you want to keep separate jobs, sites, or sessions clearly split for analysis and review.

As a rule:

• same run, same review context: one bundle
• different runs, different reporting context: separate bundles

If you are new to recorded workflows, start with Getting started and Ways to use Vidsy.ai.