搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

staryone/motlab

多媒体与设计

把视频当作代码:在无头 Chrome 中按 Canvas 场景渲染成 MP4,并提供审片界面和 Agent 技能。

177
23
JavaScript
MIT
创建于 1 天前

项目介绍

motlab 把视频当作代码来做:每个场景都是一个普通 HTML 页面,包含一个 canvas 和一个 renderAt(t) 函数,负责画出时间 t 对应的帧。网页版审片器会真实播放这些场景页面,带音频和可逐帧步进的时间轴;motlab render 则在无头 Chrome 中渲染,用页面内的 WebCodecs 编码帧,再由 ffmpeg 拼接分片并混入音频。整个过程不使用 AI 图像或视频模型。

修改意见直接在审片器里标注:点击某一帧、拖框圈出区域,或标记一段时间并输入备注。备注会写入 selection.json,Agent 可以按编号逐条处理。导出支持 720p、1080p、1440p 和 4K MP4,同一项目的多个版本并排保留,新剪辑不会覆盖旧版本。

项目附带 Agent 技能:motlab 根据参考文件夹和简短需求写出各个场景,motlab-assets 则以同样方式生成可复用的素材包,包括图标、插画、带骨骼的 2D 角色、转场、3D 物体和贴图。

快速使用

先准备 Node.js 24+、Google Chrome 或 Chromium,以及加入 PATH 的 ffmpeg 和 ffprobe。Python 3 和 Blender 是可选项,分别用于技能的辅助脚本和 3D 素材流程。

npm install -g @motlab/cli
npx @motlab/cli setup

setup 默认把技能安装给 Claude Code;Codex、Cursor、OpenCode、GitHub Copilot、Gemini CLI、Amp 和 Windsurf 用 --skill agents,Antigravity 用 --skill antigravity,其他 Agent 用 --skill-dir <技能文件夹>。安装后需要新开一次 Agent 会话。

打开示例项目:在存放它的目录运行 motlab edit example,然后访问 http://127.0.0.1:4173/p/example/。空格键播放,方向键逐帧步进,Ctrl+滚轮缩放时间轴,在预览上拖动即可框选。制作自己的视频时,把参考素材放进一个文件夹,给 Agent 这样一段需求:

Make a 20 second portrait promo for my app with motlab. The references are in ./promo-refs.

Agent 会生成场景并打开审片器;留下备注后点击导出,视频写入项目的 out/ 目录。也可以用命令行直接渲染:

motlab render example --scale 1

使用约束

  • 目前只在 Windows 上做过完整测试。CI 在 Ubuntu 上运行测试和端到端渲染,但 Linux 上还没有产出过真实视频,macOS 完全未测试。
  • 有 GPU 会更快;测试笔记本上用软件绘制会明显变慢,没有 GPU 的机器尚未测试。
  • 不装 Agent 也能用引擎和审片器,自己手写场景页面即可;但由 Agent 生成视频的工作流依赖已安装的技能。
  • 项目处于 alpha 阶段:端到端只做过两个真实视频,路线图里还列着未完成项,alpha 版本的输出尚未构建。
  • 采用 MIT 许可证;项目中引入的字体、素材、音乐等文件各自保留原有许可。

HotRepo 点评

motlab 于 2026-11-17 进入 HotRepo 新项目榜,约 13.5 小时内新增 101 星,另外新增 10 个 fork。站内没有记录到它在全部语言日榜上的名次,且只有一条 Star 采样,因此无法据此判断更长时间的趋势。更值得看的是架构:帧在浏览器页面内编码,而不是逐帧截图再交给 ffmpeg。维护者在同一台 Windows 笔记本上给出的基准中,同一个 1080p 场景耗时 9.5–12.6 秒,HyperFrames 为 27.2 秒,Remotion 为 30.7 秒;这只是单机单场景的测量,不能当作普遍的速度结论。

项目源码与说明

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. Moh4696/cinematic-skill让编程智能体自动制作带旁白的纪录短片,所有画面由 Python 与 Skia 代码逐帧绘制。Python111
  2. win4r/video-director一个指导编程智能体规划、编写并质量检查代码渲染短视频的 Claude 技能。Python274
  3. remotion-dev/remotion用 React 组件写视频并批量渲染,给需要程序化、数据驱动视频的团队一个不用时间轴的方案。TypeScript66,996
  4. 0xS4N4TG/kinetograph用 TypeScript/Remotion 编写视频,通过面向 Agent 的 CLI、Studio 和 MCP 服务在本地渲染。TypeScript263
  5. sarpstar/cinecode面向 Claude Code 或 Cursor 的技能,把一句话想法变成代码逐帧渲染、带设计音效的 MP4 影片。Python1,176