Skip to main content

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.

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 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 with external reference data.

For JSON reference files, Vidsy.ai matches reference entries to recordings in the bundle by video filename. It then compares the reference events with Vidsy events and shows the result in the recording view.

Comparison results can show:

  • events that match
  • events with different values
  • Vidsy events with no matching reference event
  • reference events with no matching Vidsy event
  • reference entries that cannot be mapped to a known Vidsy event

Results are temporary review data. They do not replace the stored analysis results in the bundle. Unmatched or unknown reference events can also appear in the Dashboard while you scrub through the recording.

XML reference files are accepted by the compare flow but are not visualized yet.

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.