kaanarici/videoscrub

README preview

# videoscrub

Ask your coding agent questions about a video.

Give it a local file or a video link. videoscrub lets the agent inspect frames, find moments, and search captions. It works with Codex, Claude Code, and other MCP hosts that support image input.

> "When does the presenter open the settings panel?"
>
> "What changes between the beginning and end of this recording?"
>
> "How many times does the indicator turn on? Give me the timestamps."

Your agent chooses what to inspect. You do not need to pick frame rates or learn the tools.

## Install

Install [Bun](https://bun.sh), [ffmpeg](https://ffmpeg.org/download.html), and [yt-dlp](https://github.com/yt-dlp/yt-dlp#installation). ffmpeg includes ffprobe. You only need yt-dlp for video links.

On macOS with Homebrew, install the video tools with:

View full repository on GitHub →