Service: Web Video Review - EyevinnOSC/community GitHub Wiki

Getting Started

Stream and analyze broadcast video files stored in S3-compatible storage with the open source tool Web Video Review running as a service in Eyevinn Open Source Cloud. This professional web application provides real-time video streaming, advanced analysis tools, and comprehensive video review capabilities without the need to host your own infrastructure.

Prerequisites

  • If you have not already done so, sign up for an OSC account.
  • A storage bucket containing video files for review. Create and manage storage buckets with the open web service MinIO.
  • Video files stored in S3-compatible storage in supported formats (MP4, MOV, AVI, MKV, MXF, MPEG-TS, M2TS).

Store access credentials as secrets

Create secrets for the access credentials to the storage server, for example accesskeyid and secretaccesskey. Read the guide on how to work with secrets for instructions on how to create a secret and refer to it.

What is Web Video Review?

Web Video Review is a professional video review application that enables you to:

  • Stream videos directly from S3: Access video files stored in S3-compatible storage with real-time HLS streaming
  • Advanced video analysis: EBU R128 loudness measurement, audio waveform visualization, and video thumbnail generation
  • Timeline navigation: Dynamic timeline controls for precise video navigation and review
  • Multi-track audio support: Review and analyze multiple audio tracks within video files
  • Broadcast format support: Native support for professional broadcast formats including MXF, TS, and M2TS

Setting up Web Video Review

Step 1: Create Web Video Review Instance

Navigate to the Web Video Review service in the OSC web user interface.

Click on the "Create service" button to create a new instance.

Enter the following required values in the creation dialog:

  • Name: video-review (or your preferred instance name)
  • AccessKeyId: {{secrets.accesskeyid}}
  • SecretAccessKey: {{secrets.secretaccesskey}}
  • Bucket: your-video-bucket-name

Optional configuration parameters:

  • s3Region: Specify if using AWS S3 (e.g., us-east-1)
  • s3Endpoint: Custom S3 endpoint URL (required for MinIO or other S3-compatible services)
  • awsSessionToken: AWS session token if using temporary credentials

You can also create the instance using the OSC command line tool:

% npx -y @osaas/cli create eyevinn-web-video-review video-review \
  -o AccessKeyId="{{secrets.accesskeyid}}" \
  -o SecretAccessKey="{{secrets.secretaccesskey}}" \
  -o Bucket="your-video-bucket-name" \
  -o s3Endpoint="https://your-minio-endpoint.com"

Step 2: Access the Video Review Interface

Once the instance is created, you can access the video review interface using the provided URL from the instance card. Open the URL in your web browser to access the Web Video Review application.

Using Web Video Review

Browsing Video Files

  1. Video Library: Browse your video files in the sidebar, organized by your S3 bucket structure
  2. File Selection: Click on any video file to load it for review
  3. Format Support: The application automatically handles transcoding for various video formats

Video Analysis Features

Timeline Navigation

  • Use the timeline controls for precise navigation through your video content
  • Scrub through videos with frame-accurate positioning
  • View video thumbnails along the timeline for quick visual reference

Audio Analysis

  • EBU R128 Loudness Measurement: Real-time loudness analysis for broadcast compliance
  • Audio Waveform Visualization: Visual representation of audio levels and characteristics
  • Multi-track Support: Switch between and analyze different audio tracks in your video files

Video Review Tools

  • Live HLS Streaming: Smooth video playback directly from S3 storage
  • Dynamic Thumbnail Generation: Automatic thumbnail creation for timeline navigation
  • Broadcast Format Support: Native support for professional formats like MXF and MPEG-TS

Example Use Cases

Broadcast Content Review

Review broadcast-ready content for technical compliance:

% npx -y @osaas/cli create eyevinn-web-video-review broadcast-review \
  -o AccessKeyId="{{secrets.accesskeyid}}" \
  -o SecretAccessKey="{{secrets.secretaccesskey}}" \
  -o Bucket="broadcast-content" \
  -o s3Endpoint="https://broadcast-storage.minio.example.com"

Access the interface to review MXF files, check audio levels, and verify technical specifications.

Post-Production Review

Set up a review workflow for post-production content:

% npx -y @osaas/cli create eyevinn-web-video-review post-production \
  -o AccessKeyId="{{secrets.accesskeyid}}" \
  -o SecretAccessKey="{{secrets.secretaccesskey}}" \
  -o Bucket="post-production-files" \
  -o s3Region="us-west-2"

Review final cuts, check audio synchronization, and validate content before distribution.

Performance and Technical Notes

  • On-demand Transcoding: The application performs video transcoding as needed for optimal streaming performance
  • Dynamic Caching: Thumbnails and analysis data are cached for improved performance
  • HLS Streaming: Efficient adaptive streaming ensures smooth playback across different network conditions
  • S3 Integration: Direct integration with S3-compatible storage eliminates the need for local file transfers

Troubleshooting

  • Videos not loading: Verify that your S3 credentials are correct and the bucket is accessible
  • Playback issues: Ensure your video files are in supported formats and properly stored in S3
  • Access denied errors: Check that your S3 credentials have read permissions for the specified bucket
  • Slow loading: Verify network connectivity to your S3 endpoint and consider using a CDN for better performance

Support

Join our Slack workspace for real-time support and to connect with other users working with video review workflows.