VidIQ - Video Intelligence & Query Tool

Download, understand, and manipulate any video from a URL.

Commands

# Video info (duration, resolution, codecs)
{baseDir}/scripts/vidiq.sh <url_or_path> info

# Extract N frames evenly spaced
{baseDir}/scripts/vidiq.sh <url_or_path> frames 10

# Single frame at timestamp
{baseDir}/scripts/vidiq.sh <url_or_path> frame 01:30:00

# Clip between timestamps
{baseDir}/scripts/vidiq.sh <url_or_path> clip 01:01:01 01:20:01 output.mp4

# Create GIF (start time, duration in seconds)
{baseDir}/scripts/vidiq.sh <url_or_path> gif 00:45:00 5

# Extract audio as MP3
{baseDir}/scripts/vidiq.sh <url_or_path> audio

# Detect scene changes
{baseDir}/scripts/vidiq.sh <url_or_path> scenes 0.3

# Visual mosaic (columns, total frames)
{baseDir}/scripts/vidiq.sh <url_or_path> mosaic 4 16

AI Analysis Workflow

1. Extract frames: vidiq.sh frames 10
2. Feed frames to vision model for content understanding
3. Answer questions about the video based on frame analysis

Supported Platforms

YouTube, TikTok, Instagram, X/Twitter, any direct video URL, local files.

Notes

• Downloaded videos are cached in /tmp/vidiq/ for reuse
• Frames output to /tmp/vidiq/frames_*/
• For long videos, extract more frames for better coverage
• GIFs are optimized with palette generation for small file size