Skip to main content

Bundles

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

Instead of treating each file as a separate job, Vidsy.ai lets you group one or more videos into a single bundle so you can 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
  • review multi-camera footage from the same run
  • record directly into a project instead of saving loose video files

What a bundle contains​

A bundle can contain:

  • one or more video files
  • the analysis results generated for those files
  • playback state for review
  • bundle-level event data used during analysis and review

If you are working inside a project, new recordings are saved into that project's recordings folder and added to the selected bundle.

Common ways to 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.

What you can do with a bundle​

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

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 files or only selected files when that option is available

Review detections and measurements​

After analysis, bundles become the review surface for recorded footage.

You can:

  • play through the timeline
  • inspect detected events
  • review observations and overlays
  • jump through the video during analysis or after it finishes

Bundles support Synchronized play.

Turn this on when the files in the bundle represent the same time window, for example different cameras covering the same inspection.

With synchronized play enabled:

  • the bundle uses one shared timeline
  • playback and analysis progress stay aligned across files
  • the longest file defines the bundle duration

With synchronized play turned off:

  • each file keeps its own playback position
  • the bundle behaves more like a collection of separate recordings
  • total duration is treated as the sum of the files

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 files from a bundle or deleting the whole bundle also removes the related analysis data for those recordings, so the bundle stays consistent with what is actually stored inside it.

Advanced bundle actions​

Some bundle actions depend on which Vidsy.ai runtime you are using.

CSV validation in master mode​

In master mode, the bundle menu includes Validate CSV...

This is used to compare analyzed events against CSV validation data and helps you:

  • score prediction quality
  • find missed events
  • flag wrong or badly timed detections

Bundle actions in Pipes runtime​

In Pipes runtime, projects can expose extra bundle action buttons.

These are project-specific actions that run against the currently selected bundle. If your project includes them, they appear next to the normal bundle controls.

When to use one bundle vs multiple bundles​

Use one bundle when the videos 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.