Video Read

Video Read

Analyze video files using Gemini 2.5 Flash (native video understanding) or GPT-4o (frame extraction fallback).

Usage

Local video file:

prbot video read -f <video_path> [-m gemini|gpt4o] [-p "custom prompt"]

Slack file by ID:

prbot video read --slack-file <FILE_ID> [-m gemini|gpt4o] [-p "custom prompt"]

Slack file by URL:

prbot video read --slack-url "<SLACK_FILE_URL>" [-m gemini|gpt4o] [-p "custom prompt"]

Parameters

• -f, --file: Local video file path (.mp4, .webm, .mov, .avi, .mkv)
• --slack-file: Slack file ID (auto-downloads then analyzes)
• --slack-url: Slack file URL (auto-downloads then analyzes)
• -m, --model: AI model to use (default: gemini)
  • gemini — Gemini 2.5 Flash with native video understanding (recommended)
  • gpt4o — GPT-4o with frame extraction via ffmpeg
• -p, --prompt: Custom analysis prompt (optional, default focuses on step-by-step actions, UI state, errors)

Note: Exactly one of --file, --slack-file, or --slack-url must be provided.

Examples

# Analyze a screen recording with Gemini (default, best quality)
prbot video read -f ./recording.mp4

# Use GPT-4o fallback
prbot video read -f ./demo.mp4 -m gpt4o

# Analyze a video shared in Slack
prbot video read --slack-file F0AMXCK3JQ1

# Custom analysis prompt
prbot video read -f ./bug-repro.mp4 -p "What bug is being demonstrated? What are the exact steps to reproduce it?"

Output

Outputs a detailed text description of the video content, followed by model and usage metadata.

Notes

• Gemini path sends the full video as base64 inline data — best for understanding temporal changes
• GPT-4o path extracts frames at 1fps with ffmpeg, samples every other frame — requires ffmpeg installed
• Supported formats: .mp4, .webm, .mov, .avi, .mkv, .m4v
• Requires GEMINI_API_KEY env var for Gemini, OPENAI_API_KEY for GPT-4o