How neartana/rea-video works
rea-video is a video reverse-engineering CLI: an engineer or agent supplies a clip, the tool analyzes it shot by shot, and returns a breakdown, remake plan, and HTML report. Its stages cover media inspection and shot sampling, visual and audio forensics, production-method classification, packaging and cinematography analysis, optional model or agent review, and synthesis into reports and remake outputs. The pipeline and CLI excerpts/index support the main wiring; several capabilities are documented in the README but their internals were not sampled, so those links are marked unverified.
Main entry points: pipeline.py Analysis pipeline · cli.py CLI · vlm.py Vision model · review.py Agent review
Components 23
Entry and orchestration
- CLI
rea_video/cli.py - Analysis pipeline
rea_video/pipeline.py
Media analysis
- Media inspection
rea_video/media.py - Video probing
rea_video/probe.py - Shot detection
rea_video/shots.py - Visual features
rea_video/features.py - Visual analysis
rea_video/visual.py - Motion analysis
rea_video/motion.py - Audio analysis
rea_video/audio.py - Sound sourcing
rea_video/sound_source.py
Interpretation and review
- Production classifier
rea_video/classify.py - Production aspects
rea_video/aspects/base.py - Text and overlays
rea_video/packaging.py - Vision model
rea_video/vlm.py - Agent review
rea_video/review.py - Analysis memory
rea_video/memory.py
Plans and outputs
- Remake planning
rea_video/plan.py - HTML report
rea_video/report.py - Audio stems
rea_video/stems.py
External integrations
- Remake export
rea_video/integrations/capsule_cinema.py
Other components
- Engineer or agent
- Vision model service
- Capsule Cinema
Connections 25
- Engineer or agent → CLI: runs analysis
- CLI → Analysis pipeline: runs pipeline
rea_video/cli.py - Analysis pipeline → Media inspection: reads video
rea_video/pipeline.py - Analysis pipeline → Video probing: probes media
rea_video/pipeline.py - Analysis pipeline → Shot detection: samples shots
rea_video/pipeline.py - Analysis pipeline → Visual features: extracts features
rea_video/pipeline.py - Analysis pipeline → Visual analysis: analyzes visuals
rea_video/pipeline.py - Analysis pipeline → Motion analysis: analyzes motion
rea_video/pipeline.py - Analysis pipeline → Audio analysis: analyzes audio
rea_video/pipeline.py - Analysis pipeline → Sound sourcing: identifies sound
rea_video/pipeline.py - Analysis pipeline → Production classifier: classifies shots
rea_video/pipeline.py - Analysis pipeline → Production aspects: measures aspects
rea_video/pipeline.py - Analysis pipeline → Text and overlays: analyzes overlays
rea_video/pipeline.py - Analysis pipeline → Vision model: requests judgments
rea_video/pipeline.py - Analysis pipeline → Remake planning: builds plan
rea_video/pipeline.py - Vision model → Vision model service: sends prompts
- CLI → Agent review: offers review
rea_video/cli.py - Agent review → Analysis memory: uses patterns
rea_video/review.py - CLI → Analysis memory: uses memory
rea_video/cli.py - CLI → Audio stems: extracts stems
rea_video/cli.py - CLI → HTML report: produces report
- CLI → Remake export: exports remake
rea_video/cli.py - Remake export → Capsule Cinema: creates jobs
- Analysis pipeline → HTML report: feeds breakdown
rea_video/pipeline.py - Analysis pipeline → Text and overlays: writes timeline
rea_video/pipeline.py