MAVA Exchange Documentation

A lightweight interchange format for video annotations.

What is MediaPkg?

MediaPkg (.mediapkg) packages video annotation data in a portable format. It uses:

• Parquet for efficient columnar storage

• JSON-LD for semantic metadata

• ZIP for compression and bundling

Quick Example

from mava_exchange import MediaPackageWriter, ObservationSeries, DimensionSpec

# Define a track
emotions = ObservationSeries(
    name="emotions",
    description="Face emotions",
    sampling_interval=0.5,
    dimensions=[DimensionSpec("happy", "Happiness", "[0,1]")]
)

# Write package
with MediaPackageWriter("output.mediapkg") as w:
    w.add_video("v001", "video.mp4")
    w.add_track("v001", emotions, df)

See full tutorial →

Contents

Getting Started

• Getting Started
  • Installation
  • Concepts
  • 1. Writing a .mediapkg
  • 2. Reading a .mediapkg
  • 3. Validating a .mediapkg
  • 4. Inspecting from the CLI
  • 5. The .mediapkg format at a glance
  • Next steps

User Guide

• Writing Packages
• Reading Packages
• Track Types
• Validation
• Command Line Tools

Reference Guide

• Reference Guide

Specification

• MediaPkg Format Specification
• MAVA Ontology
• Viewer for mediapkg files