README

Reverse-engineer any video.

Shot by shot: was it filmed, AI-generated or coded, and how to remake it.

Website | 中文 | English | Русский | 日本語 | 한국어 | Español | Português | Français | Deutsch


!Python
!Agent



  

⭐ Help more people find rea-video. Star this repo!



Left: a TikTok ad shot on a phone. Right: an AI remake with another product. rea-video's verdict: the left is all live footage, one set and two camera positions; the right is all AI, 8 shots across 3 generations.



 Quick start

rea-video is built for AI agents. In Claude Code, Codex or any agent that can run commands, say:

text
Install https://github.com/JuneYaooo/rea-video, then break down this video: /path/to/video.mp4


The agent installs the CLI, learns the workflow and runs the whole thing. You need ffmpeg and Python 3.10+.

Install by hand

bash
brew install ffmpeg             or: sudo apt install ffmpeg
git clone https://github.com/JuneYaooo/rea-video && cd rea-video
bash scripts/install_skill.sh   installs the CLI (pip, or pipx / a local .venv if pip is blocked) and links the skill into ~/.claude, ~/.codex, ~/.agents
rea-video --help




You get:

- a one-line summary, e.g. "41% AI video + 59% code UI, 8 s of real screen recording, library music at 122 BPM"
- a remake plan, split into what to film, what to generate and what to code
- a full report.html with per-shot frames, evidence, prompts, camera and lighting notes, and the audio breakdown

You can also hook up a video-capable model (Gemini or Doubao both work) by giving the agent its endpoint and key. That makes the live/AI/3D calls more accurate and adds a reverse-engineered prompt for every shot. It works fine without one; if your agent can see images, it checks the uncertain shots itself.

 Reports are written in whichever language you ask in (Chinese or English). The example reports below are in English.

 What it can break down

| Video type | Examples | What you get |
|---|---|---|
| Live footage | Talking-head, tabletop, handheld product demo, vlog, store visit | Setups and camera positions, framing, camera moves, lighting (12 setups with gear lists), color grade |
| AI video | Text/image-to-video, AI short drama, AI music video | Evidence, a reverse-engineered prompt per shot, how to batch into generations and which model to use |
| Avatar | A portrait driven by audio, lip-sync | Which shots are avatar shots, what portrait and audio you need |
| 3D / animation | Blender / C4D explainers, product animation, 2D animation, stop-motion | Whether to generate with a video model or render from 3D code |
| Code / template | Kinetic type, UI demos, charts, slide-style cards | Text, layout and motion timing, ready to rebuild as a Remotion project |
| Screen recording | Software tutorials, web demos | Which parts are real material you'll need to record yourself |
| Mixed / edits | AI characters + code UI + real screen capture; live footage with AI edits | Each shot judged separately, then reassembled on the original tim

Top issues

Discussions