← all repositories
bradautomates/claude-video

Making Claude watch videos so you don't have to

It downloads, frames, and transcribes video so Claude can answer questions about what actually happens on screen and in the audio.

9.6k stars Python Coding AssistantsAgents
claude-video
Velocity · 7d
+153
★ / day
Trend
cooling
star history

What it does Claude Video is essentially well-engineered glue: a portable skill for Claude Code, claude.ai, and Codex that orchestrates yt-dlp, ffmpeg, and optional Whisper to close the gap between Claude’s text-and-code prowess and the video format it otherwise can’t ingest. Feed it a public URL or local file and it produces timestamped frames and a transcript so Claude can Read the visuals in parallel and answer questions grounded in actual on-screen action and audio rather than guessing from titles.

The interesting bit The craft is in the frame budget logic. The skill auto-scales extraction rates based on duration, hard-capping at 100 frames and 2 fps so a 30-minute video doesn’t burn your token limit. Focused --start/--end windows swap coverage for density, which is far more useful than a sparse skim of an entire livestream.

Key highlights

  • Supports hundreds of public platforms via yt-dlp plus local .mp4, .mov, .mkv, and .webm files.
  • Native captions are free and preferred; Whisper via Groq or OpenAI is a fallback for caption-less sources like TikToks or screen recordings.
  • macOS auto-installs dependencies on first run; other platforms get exact manual commands printed to the terminal.
  • Useful for debugging UI glitches from screen recordings, analyzing competitor video hooks, or summarizing talks without pressing play.

Caveats

  • Videos over 10 minutes trigger a “sparse scan” warning; meaningful analysis requires narrowing the window with --start/--end.
  • No authenticated platforms: if yt-dlp can’t fetch it without logging in, neither can this skill.
  • Whisper audio uploads are limited to 25 MB (~50 minutes at mono 16 kHz), so long caption-less content may need to be chunked.

Verdict Worth it if you want Claude to audit visual content, debug screen recordings, or summarize short-to-medium videos without watching them yourself. Less useful if you need deep, frame-dense analysis of long-form content without slicing it into segments first.

Frequently asked

What is bradautomates/claude-video?
It downloads, frames, and transcribes video so Claude can answer questions about what actually happens on screen and in the audio.
Is claude-video open source?
Yes — bradautomates/claude-video is open source, released under the MIT license.
What language is claude-video written in?
bradautomates/claude-video is primarily written in Python.
How popular is claude-video?
bradautomates/claude-video has 9.6k stars on GitHub and is currently cooling off.
Where can I find claude-video?
bradautomates/claude-video is on GitHub at https://github.com/bradautomates/claude-video.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.