Video Clip Adapter
Video Clip Adapter
- images
- alpha
- IMAGE
- MASK
Here's the thing about video generation in ComfyUI: your Wan, Hunyuan, or LTX sampler does not give you a video file. It gives you a batch of IMAGE frames. Making those frames into an actual playable, editable clip is a whole step, and the Montagen Video Clip Adapter is that step - the reason to use ComfyUI-Montagen at all.
The pack is a video studio living inside the node graph: projects, timelines, an embedded editor, a renderer. Feed this adapter a batch of frames and a name, and on execution it encodes them into a real video file (MP4, or WebM if there's an alpha channel), writes it into the project, and registers it as a clip on the timeline. The duration is computed for you as frame count ÷ fps, so the clip lands at the right length. It's an output node - the clip is the point, not the return value - but it still passes the IMAGE and MASK out the other side so you can keep the wire running.
The inputs that matter
- images - your batch of frames straight off the video model or from a Video Combine–style node.
- name - the clip's ID. Defaults to "Untitled Clip"; name it something you'll recognize in the Clips panel.
- preview_fps - defaults to 25, and this is the one to watch. It controls the encoded clip's frame rate and the duration math. If your generator ran at a different fps, set this to match or your clip will come out the wrong length.
- alpha (optional) - a MASK for transparency; with alpha present the node encodes WebM instead of MP4 so the transparency survives.
- tag (optional) - a label for organizing clips.
Wiring it in
Same recipe as the other adapters, per the README: open a Montagen project from the activity bar, add a Create Timeline node (resolution + FPS), connect this adapter into it, then Execute Timeline to render everything to builds/. The payoff is the workflow pattern the pack is built for: generate a batch of shots with a video model, feed them through adapters, and assemble a multi-clip timeline - cuts, overlaps, a voiceover track from the Audio Clip Adapter - without ever exporting and reimporting frames into a separate editor.
Install
cd ComfyUI/custom_nodes
git clone https://github.com/MontagenAI/ComfyUI-Montagen.git
Or find "ComfyUI-Montagen" in ComfyUI Manager and hit Install. No model downloads for the adapters; Manager installs the pip deps (ffmpeg-binaries, smbprotocol, edge_tts, fish-audio-sdk). The one you actually need here is ffmpeg - no working ffmpeg, no encoded clips. Then restart ComfyUI properly, not just refresh, or the Montagen activity-bar extension won't load and you'll wonder where the whole UI went.
Common issues
- Wrong clip duration. You ran your video model at 16 or 30 fps but left
preview_fpsat 25. The adapter doesn't know your generation fps - it uses this field for both encoding and the duration calculation, so set it to match your sampler. - "Nothing happens" when run standalone. Like every adapter in this pack, it only means something inside a Montagen project with a Create Timeline node. Bare execution gets you errors, not clips.
- Old workflows hit a missing node. The pack renamed its adapters after 0.2.x: "Video Clip Adapter" (
MontagenVideoClipAdapter) became "Video Adapter" (MontagenVideoAdapter). Re-add it from the menu. - You're an early adopter. This is a small, actively-developed pack with close to no community presence - the README and CHANGELOG are the docs, expect rough edges, and install from the official repo since Manager will execute whatever it clones.
Inputs (5)
| Name | Type | Default | Description |
|---|---|---|---|
| images | IMAGE | The images to preview. | |
| name | STRING | Untitled Clip | — |
| preview_fps | INT | 25 | — |
| tagopt | STRING | The tag. | |
| alphaopt | MASK | The alpha to preview. |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| IMAGE | IMAGE | — |
| MASK | MASK | — |