HUANGCHIHHUNGLeo/claude-real-video

# claude-real-video — let Claude actually watch a video

## When to use

The user gives you a video (URL or file path) and asks what's in it, to summarize it, to analyze its structure, or to answer questions about it.

## Requirements

- `pip install "claude-real-video[whisper]"` (installs the `crv` CLI; needs Python 3.10+ and ffmpeg)
- The `[whisper]` extra is required for speech-to-text — pip never installs extras on its own. The first transcription then downloads a whisper base model (~139 MB).

## Steps

1. Run the extractor (add `--grid` to cut image count ~9x — recommended):

# claude-real-video / crv Pro — 幫 Leo 看影片

Leo 本機裝的是 **Pro 版 0.5.0**（`~/Projects/crv-pro/.venv/bin/crv-pro`，PATH 有的環境直接 `crv-pro`）。

## 什麼時候用

Leo 給影片（網址或檔案路徑）問內容、要摘要、拆對標 reel、問「他怎麼講/怎麼拍/觀眾為什麼買單」時。

## 指令怎麼選（0.5.0）

| Leo 的話聽起來像 | 指令 |
|---|---|
| 「這在講什麼」「幫我摘要」「他說的是真的嗎」 | `crv-pro "<src>" -o out --mode watch` |
| 「怎麼做的」「拆解」「為什麼會紅」「能學嗎」 | `crv-pro "<src>" -o out --mode creator` |

# claude-real-video — let Claude actually watch a video

## When to use

The user gives you a video (URL or file path) and asks what's in it, to summarize it, to analyze its structure, or to answer questions about it.

## Requirements

- `pip install "claude-real-video[whisper]"` (installs the `crv` CLI; needs Python 3.10+ and ffmpeg)
- The `[whisper]` extra is required for speech-to-text — pip never installs extras on its own. The first transcription then downloads a whisper base model (~139 MB).

## Steps

1. Run the extractor (add `--grid` to cut image count ~9x — recommended):

# claude-real-video — let Claude actually watch a video

## When to use

The user gives you a video (URL or file path) and asks what's in it, to summarize it, to analyze its structure, or to answer questions about it.

## Requirements

- `pip install "claude-real-video[whisper]"` (installs the `crv` CLI; needs Python 3.10+ and ffmpeg)
- The `[whisper]` extra is required for speech-to-text — pip never installs extras on its own. The first transcription then downloads a whisper base model (~139 MB).

## Steps

1. Run the extractor (add `--grid` to cut image count ~9x — recommended):

# claude-real-video for AI agents

## What is crv?

`crv` (claude-real-video) is a CLI tool that extracts meaningful frames and transcripts from videos so AI agents can "see" and "read" them. It uses scene-change detection (not fixed-interval sampling), sliding-window deduplication, and optional Whisper transcription.

**Key advantage**: Same 58-second clip at fixed 1fps = 58 frames. crv keeps the **26 that actually differ**, and `--grid` packs them into **3 contact sheets**. Fewer tokens, nothing missed.

## Installation

### Prerequisites

- Python 3.10+
- ffmpeg / ffprobe on PATH