Skip to main content

Analyze Command

The analyze command performs a comprehensive analysis of a video file or YouTube video, combining frame extraction, content analysis, and audio transcription. This provides a complete understanding of the video content.

Usage

Arguments

Options

Examples

Analyze a local video file

Analyze a YouTube video

Analyze with custom frame interval

Analyze with specific transcription model

Output

The command creates a comprehensive directory structure with analysis results:
  • frames/: Directory containing extracted frames
  • metadata.json: Metadata about the video
  • analysis.json: Frame-by-frame analysis
  • transcript.txt: Audio transcript
  • summary.json: Overall summary of the video content
  • video.mp4: The downloaded video (if from YouTube)

Analysis Process

The analyze command performs the following steps:
  1. If a YouTube URL is provided, downloads the video
  2. Extracts frames at the specified interval
  3. Analyzes each frame using AI vision models
  4. Extracts and transcribes the audio
  5. Combines the frame analysis and transcript to create a comprehensive summary
  6. Saves all results in the output directory

Summary Format

The summary.json file contains a comprehensive summary of the video:

Use Cases

The analyze command is useful for:
  • Content creators analyzing their videos
  • Researchers studying video content
  • Educators creating accessible materials
  • Marketers understanding video engagement
  • Archivists cataloging video collections