blixvip/NullMotion

选用指南

AI 根据 README 整理 · 2026/10/16 19:06:39

使用方式

通过本地服务器运行，在浏览器中打开预览页面，使用下载按钮导出MP4。

查看 README 依据

git clone https://github.com/blixvip/NullMotion.git && cd NullMotion npm start # Node 22+, nothing to install ``` Then open **<http://127.0.0.1:4343>**, pick a reference, and press **Download → Whole preview** (Chrome or Edge) to get the MP4. No `npm install`, no API keys, no account. Three references ship with the repo, so it works on the first run.

部署要求

需要Node.js 22+运行本地服务器，导出MP4需使用Chrome或Edge浏览器，导入自有参考素材需FFmpeg/ffprobe和Python 3。

查看 README 依据

4. **Export.** A hidden copy of the film plays at half speed. `requestVideoFrameCallback` captures every decoded frame, the drafts are drawn at that frame's exact time, and WebCodecs encodes it at 24 Mbps with the frame's own timestamp. The audio is copied from the reference, and [mp4-muxer](https://github.com/Vanilagy/mp4-muxer) writes the MP4. Nothing is recorded in real time, so no frames are dropped. ### Requirements | | Needed for | |---|---| | **Node.js 22+** | Running the local server (`npm start`). No dependencies to install. |

| **Chrome or Edge** | MP4 export (WebCodecs + `requestVideoFrameCallback`). Playback works in any modern browser. | | **FFmpeg / ffprobe** (optional) | Importing your own references, planning sections, rebuilding the showcase, and extracting audio for imported references. | | **Python 3** (optional) | `scripts/import-motionclone.py`. | ## Bring your own references With Python, FFmpeg and ffprobe installed: ```sh python scripts/import-motionclone.py --source /path/to/MotionClone node scripts/plan-sections.mjs # sections + scene cuts + contact sheets ```

已知限制

不支持制作竖版片段、剪切停顿或添加字幕，这些功能属于Null Studio；生成、渲染服务和Premiere未连接，草稿为手工编写而非AI生成。

查看 README 依据

`--source` must point at the MotionClone project folder (the one that contains `data/`), not at a single video. **Port 4343 is already in use, or I want to open it from another device.** Set `PORT` and/or `HOST`, for example `PORT=5000 npm start` or `HOST=0.0.0.0 npm start` (default `127.0.0.1:4343`). **The template gallery or editor says "generation not connected".** That's intentional. Generation, rendering services, and Premiere are not connected in this repo, and the server answers those calls with `501 NOT_CONNECTED`. The drafts are authored, not AI-generated.

**Can I make vertical clips, cut pauses, or add captions with this?** No. Those are features of Null Studio at [nullmotion.com](https://www.nullmotion.com/), a separate hosted product. Stuck on something else? Ask in the **[Discord](https://discord.gg/zEB4VjmfSb)** or [open an issue](https://github.com/blixvip/NullMotion/issues/new/choose). ## Project layout ``` public/demo.html · demo.mjs · demo.css the preview page and exporter public/drafts.mjs HyperFrames draft engine (beat kinds)