vvv — Claude Code plugin: what it does, how to install
vvv is a Claude Code plugin that creates and edits Remotion videos from reusable templates. It aligns photo cuts to music beats and renders video projects.
MIT ★ 568 updated 2026-10-30
/plugin marketplace add actionow-ai/vvv
/plugin install vvv@vibevisionWhat vvv does
The plugin automates video generation using Remotion and pre-built design layouts. The agent organizes images across scenes, matches slide timings to musical bars, and generates editable React and TypeScript code. Users can adjust parameters directly or refine generated code inside the project.
It can also deconstruct reference videos frame by frame to replicate timing patterns using new media. The built-in vvv check command validates the output by flagging frozen frames, checking volume levels, and spotting cuts that missed the beat.
Local rendering strictly requires Python 3.9+, Node.js 26, and npm. The vvv.py describe helper exposes customizable text and photo slots to the agent, while validate catches invalid inputs before rendering begins.
What it helps with
- build video slideshows from photos using Remotion templates
- sync scene cuts and transitions to background music beats
- recreate reference video timing structures using personal photos and logos
- verify rendered video files for rhythm drift and stalled frames
Example prompts for the agent
- Create a video using the Album template with pictures from ./photos and music from track.mp3
- Run vvv check on the current project and list every transition off the beat
- Update project templates to the latest version with vvv.py update
How to install vvv
Plugin marketplace
/plugin marketplace add actionow-ai/vvv/plugin install vvv@vibevisionStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about vvv
How to install vvv in Claude Code?
Add the marketplace source with /plugin marketplace add actionow-ai/vvv, then run /plugin install vvv@vibevision.
What does vvv do?
It lets coding agents build, customize, and render Remotion video templates with automated beat matching and timeline verification.
What is required to run vvv?
Local rendering requires Python 3.9+, Node.js 26, and npm on the host system. Local FFmpeg utilities can also be used for media extraction.
Source text
SKILL.md · MIT
<div align="center">
<img src="docs/assets/brand/hero-zh-CN.png" width="100%" alt="Vibe Vision Video:一次构建模板,多次复用。给编程 Agent 的开源视频模板。">
<h3>换上照片和文案,就是一部新片;<br>给一部喜欢的片子,复刻出你自己的版本。</h3>
[](LICENSE)
[](https://vibevision.video/zh/)
[](https://linux.do)
[](docs/agent-compatibility.md)
[](docs/agent-compatibility.md)
[](https://vibevision.video/zh/start/#mcp)
[官网](https://vibevision.video/zh/) · [English](README.en.md) · [开始使用](docs/getting-started.md) · [模板](docs/templates.md) · [社区模板](https://vibevision.video/zh/community/) · [文档](docs/README.md)
</div>
> [!NOTE]
> **仅供学习与研究。** 本项目用于学习和研究可复用的视频模板、节拍剪辑与 Agent 工作流。示例中的新人和照片均为虚构。复刻参考视频是为了学习它的结构与节奏,请勿搬运或冒充他人作品;照片、音乐和字体请确认你有权使用。
## 用模板做出来的片子
<table>
<tr>
<td align="center" width="33%"><a href="docs/assets/doodle.mp4"><img src="docs/assets/loops/doodle.webp" width="100%" alt="Doodle:水彩爱心在 We're married! 后绽开"></a><br><b>Doodle</b> · 白纸手绘</td>
<td align="center" width="33%"><a href="docs/assets/album.mp4"><img src="docs/assets/loops/album.webp" width="100%" alt="Album:圆角画册里的恋爱故事拼版"></a><br><b>Album</b> · 留白画册</td>
<td align="center" width="33%"><a href="docs/assets/dv-story.mp4"><img src="docs/assets/loops/dv-story.webp" width="100%" alt="DV Story:PLAY 回放屏上配打字字幕的照片页"></a><br><b>DV Story</b> · DV 回放</td>
</tr>
<tr>
<td align="center"><a href="docs/assets/comedy.mp4"><img src="docs/assets/loops/comedy.webp" width="100%" alt="Comedy:放错童年照的笑点"></a><br><b>Comedy</b> · 喜剧开场</td>
<td align="center"><a href="docs/assets/starter.mp4"><img src="docs/assets/loops/starter.webp" width="100%" alt="Starter:名字逐字打出的卡点相册"></a><br><b>Starter</b> · 节拍相册</td>
<td align="center"><a href="docs/assets/album-vertical.mp4"><img src="docs/assets/loops/album-vertical.webp" width="100%" alt="Album 9:16:竖版短片里的街角拼版"></a><br><b>Album 9:16</b> · 竖版短片</td>
</tr>
<tr>
<td align="center"><a href="docs/assets/editorial.mp4"><img src="docs/assets/loops/editorial.webp" width="100%" alt="Editorial:手写标题旁的新人照片,白色泡泡扫过后圆形双人照展开"></a><br><b>Editorial</b> · 简约杂志</td>
<td align="center"><a href="docs/assets/cinema.mp4"><img src="docs/assets/loops/cinema.webp" width="100%" alt="Cinema:相遇日期下的一条线展开成第一张合照"></a><br><b>Cinema</b> · 黑幕影院</td>
<td align="center"><a href="docs/assets/memoir.mp4"><img src="docs/assets/loops/memoir.webp" width="100%" alt="Memoir:家乡地标和童年照贴纸弹出,旁边手写名字"></a><br><b>Memoir</b> · 手写胶片故事</td>
</tr>
</table>
<p align="center"><sub>点击动图观看带配乐的完整预览。全部由模板直接渲染并通过 <code>vvv check</code>,新人和照片均为虚构示例。最新加入的 <b>Editorial</b>、<b>Cinema</b> 和 <b>Memoir</b> 都从参考片复刻:简约杂志风婚礼 MV、现场大屏黑底开场片、手写胶片人生故事。<a href="docs/templates.md">全部模板、画幅与风格</a></sub></p>
## 从一堆照片到一部成片
<img src="docs/assets/art/workflow.jpg" width="100%" alt="照片从云盘落下、按服装分组、沿节拍时间线做成影片,再回到云盘保存">
把照片和想法交给 Agent,从整理照片到渲染成片,每一步它都能接手。你只需要说想法、看样片、拍板。
<table>
<tr>
<th width="25%">准备照片</th><th width="25%">理清想法</th><th width="25%">样片与修改</th><th width="25%">成片与保存</th>
</tr>
<tr>
<td valign="top"><b>01 说想法</b><br>告诉 Agent 想要的风格、画幅和歌曲,一两句话就够。</td>
<td valign="top"><b>04 理需求</b><br>整理风格、画幅、时长和歌曲。点名的歌用你手里的音乐文件,或由你自装的 musicdl 获取(仅限个人使用)。</td>
<td valign="top"><b>07 出样片</b><br>配乐自动对齐:副歌落在高潮页,渲染前先告诉你全片多长、每页停几秒。</td>
<td valign="top"><b>10 出成片</b><br>渲染 1080p 高清成片,自动检查画幅、音量、静止画面和卡点。</td>
</tr>
<tr>
<td valign="top"><b>02 放照片</b><br>照片放在本地文件夹,或给一个百度网盘分享链接。</td>
<td valign="top"><b>05 看照片</b><br>逐张识别人物、情绪和服装,按套分组;同一页用同一套,相邻两组自动换装。</td>
<td valign="top"><b>08 提意见</b><br>看完样片,直接说哪里要改。</td>
<td valign="top"><b>11 存网盘</b><br>需要时把成片存进你的百度网盘,经你确认才上传。</td>
</tr>
<tr>
<td valign="top"><b>03 取照片</b><br>Agent 下载原图,自动缩到渲染尺寸,原图不动。</td>
<td valign="top"><b>06 定方案</b><br>三选一:推荐最合适的模板、用你指定的模板,或学习一部你喜欢的参考视频的结构和节奏,用自己的素材复刻(抖音、小红书、快手链接直接用)。</td>
<td valign="top"><b>09 改到位</b><br>换照片、改文案、调节奏,逐条修改,只重渲改动的部分。</td>
<td valign="top"><b>12 留工程</b><br>可编辑工程一并留存,以后随时能改,也能交给另一个 Agent 接着做。</td>
</tr>
</table>
> 用 vvv 技能做一部婚礼 MV:照片在百度网盘 https://pan.baidu.com/s/…(提取码 abcd),歌用《咱们结婚吧》,风格参考这条小红书 https://xhslink.cn/o/…。新郎林以舟、新娘许知夏,10 月 18 日结婚。先给我看样片。
## 装进你的 Agent
任选一种:
| Agent | 安装 |
|---|---|
| **Claude Code** | `/plugin install vvv --marketplace actionow-ai/vvv`(插件里已包含模板库) |
| **Codex、Cursor、Gemini CLI、Copilot 等 20 多个** | `npx skills add actionow-ai/vvv`(再 clone 本仓库,并设置 `VVV_KIT`,[说明](docs/agent-compatibility.md)) |
| **WorkBuddy** | 从 [Releases](https://github.com/actionow-ai/vvv/releases) 下载技能 ZIP,在「技能 → 添加技能」中上传([说明](docs/workbuddy.md)) |
| **任何 MCP 客户端** | `claude mcp add --transport http vvv https://mcp.vibevision.video/mcp`,无需安装即可浏览模板和方法指南 |
渲染在你的电脑上进行,需要装好 Python 3.9+、Node.js 26 和 npm;其余依赖由 Agent 安装。可选(用你自己的账号):下载分享链接参考片用的 [TikHub](https://tikhub.io) Token、百度网盘登录、musicdl([集成说明](docs/integrations.md))。
## 一个模板,做每一部新片
场景、版式、节奏和检查只做一次。新片只改属于它自己的东西。
<table>
<tr><td><b>只做一次</b></td><td>场景结构与镜头运动 · 16:9 与 9:16 版式 · 按节拍规划的时间线 · 渲染检查</td></tr>
<tr><td><b>每部片子各自修改</b></td><td>照片 · 名字和日期 · 每一句文案 · 配乐与画幅</td></tr>
</table>
`vvv.py describe` 告诉 Agent 每个模板的照片位、可改文案和配置,`validate` 在渲染前拦下错误输入。Agent 优先改模板开放的输入,只有需求需要时才动 React/TypeScript 源码。复用模板是为了省下反复设计、生成和调试同类视频代码的 token;对照基准尚未发布,见[路线图](ROADMAP.md)。
## 给它一部你喜欢的片子,做出你自己的。
<img src="docs/assets/art/recreate.jpg" width="100%" alt="一段胶片经过节拍网格变成 V 形:拆解参考视频并重建">
把参考视频和属于你的附件交给 Agent:照片、Logo、文案、音乐。它会拆解参考片为什么好看,再用你的素材重建成一个可编辑的工程。
<table>
<tr>
<td width="33%" valign="top"><b>01 参考视频 + 附件</b><br>一个视频文件,或抖音、小红书、快手、TikTok 的分享链接,加上你的照片(本地或百度网盘)、Logo、文案和音乐。参考片只用来学习,不会被打包分发。</td>
<td width="33%" valign="top"><b>02 逐页清单</b><br>按节拍列出每一页:每个转场按 0.1 秒密集截帧,从定格帧量出照片框坐标,写清每个元素怎么进、怎么出。清单确认后才开始写代码。</td>
<td width="33%" valign="top"><b>03 重建并对照</b><br>基于最接近的模板或全新的构图。缺的素材以参考截图为风格参考生成;新旧画面并排对照,偏离节拍的峰值逐个列出。</td>
</tr>
</table>
> 用 vvv 技能把这条小红书视频 https://xhslink.cn/o/… 复刻成我们自己的片子:用 ./photos 里的照片、我们的 Logo 和文案重建,缺的画面素材用生图补上,正式渲染前先给我看检查过的样片。
有生图能力的 Agent 效果最好。本机同时装有 Claude Code 和 Codex 时,Claude Code 可以通过内置桥接调用 Codex 的生图能力。不生成视频和配音。[复刻流程](docs/capabilities.md#recreate-a-reference-video)
## 还能做什么
- **按情绪线排照片**:每个模板都标好了自己的情绪段落(先笑后泪、从相识到婚礼)。Agent 先看每张照片,标出人物、情绪和时间,再按段落放进对应位置,渲染前先给你看排好的顺序。
- **风格预设**:片头规则、配乐、署名这些定一次存成预设,之后每部片子都直接沿用,不用每次重新交代。
- **渲染检查**:`vvv check` 测量画幅、音量、静止画面和卡点,直接点出偏离节拍最多的几个画面,并列出只能由人判断的事项。
- **模板更新**:`vvv.py update` 把已有工程的模板代码更新到 kit 的最新版本,保留你自己改过的部分。
- **交接**:把模板、动效或做好的工程打包成一个 [`.vvv` 文件](docs/format/vvv-1.0.md),带上代码、素材授权和渲染验证记录,换一个 Agent 也能接着做。
- **素材工具**:本地 FFmpeg 工具可以探测媒体、截取片段、提取音轨和抽帧([示例](examples/media-workflow.md))。
- **社区模板**:做了满意的模板,打包后在[官网投稿](https://vibevision.video/zh/submit/)。站长审核通过后,它会出现在网站和 MCP 服务里。
Agent 第一次在你的电脑上运行命令时,可能会先征求你的同意。想手动运行或开发新模板,见[开始使用](docs/getting-started.md)和[贡献指南](CONTRIBUTING.md);现成的 `.vvv` 模板包附在 [Releases](https://github.com/actionow-ai/vvv/releases) 中。
<img src="docs/assets/art/cta.jpg" width="100%" alt="一排 V 形立体字,最前面一个亮成荧光黄">
<div align="center">
### 今天就做出你的第一部片子。
[开始使用](docs/getting-started.md) · [官网](https://vibevision.video/zh/) · [[email protected]](mailto:[email protected]) · [Linux.do](https://linux.do)
</div>
<table>
<tr>
<td width="33%" valign="top"><b>状态</b><br>0.2 早期版本。已在 macOS ARM64 上用 Claude Code 和 Codex 完整验证,WorkBuddy 和其他平台测试较少。<a href="docs/verification.md">验证与限制</a></td>
<td width="33%" valign="top"><b>用途与许可</b><br>仅供学习与研究。代码、文档、模板与演示素材采用 <a href="LICENSE">MIT</a>;字体、预览配乐和第三方代码沿用各自条款,其中 musicdl 仅限非商业使用:<a href="MEDIA_LICENSE.md">媒体许可</a> · <a href="THIRD_PARTY_NOTICES.md">第三方说明</a></td>
<td width="33%" valign="top"><b>参与</b><br><a href="CONTRIBUTING.md">贡献指南</a> · <a href="ROADMAP.md">路线图</a> · <a href="CHANGELOG.md">更新记录</a><br><a href="SECURITY.md">安全</a> · <a href="docs/brand.md">品牌素材</a> · <a href="https://vibevision.video/zh/submit/">投稿模板</a></td>
</tr>
</table>
<p align="center"><sub>© 2026 Vibe Vision Video contributors · <a href="https://vibevision.video/zh/">vibevision.video</a></sub></p>
© Vibe Vision Video contributors · MIT · actionow-ai/vvv