explaingit

spiritform/comfyblockout

Analysis updated 2026-05-18

4HTMLAudience · vibe coderComplexity · 3/5Setup · moderate

TLDR

A ComfyUI node with a full 3D scene editor for blocking out and animating a shot, then feeding it as video and prompt into AI generators.

Mindmap

mindmap
  root((ComfyBlockout))
    What it does
      3D blockout editor
      Camera and object keyframes
      Records to mp4
      Feeds AI models
    Tech stack
      three.js
      ComfyUI node
      ffmpeg
    Use cases
      Plan a camera move
      Animate a blockout scene
      Export video plus prompt
      Import 3D assets
    Audience
      AI video creators
      3D hobbyists
    Outputs
      Image
      Video
      Prompt string

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Block out a 3D scene with simple shapes and imported models before generating AI video.

USE CASE 2

Animate a camera path and feed the recorded clip into models like Seedance or LTX.

USE CASE 3

Design a particle effect scene and export its first frame as a start image for Flux.

USE CASE 4

Save a named project on the server so a scene can be reopened in a later ComfyUI session.

What is it built with?

HTMLJavaScriptthree.jsComfyUIffmpeg

How does it compare?

spiritform/comfyblockoutasabeneh/speaksuomibmschmidt/bookwormblog
Stars444
LanguageHTMLHTMLHTML
Last pushed2026-05-292015-05-22
MaintenanceMaintainedDormant
Setup difficultymoderateeasymoderate
Complexity3/51/53/5
Audiencevibe codergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an existing ComfyUI install to drop the node into, ffmpeg is used internally for video export.

The README does not state a license, so terms of use and redistribution are unclear.

In plain English

ComfyBlockout is a 3D editor node for ComfyUI, the node based interface many people use for AI image and video generation. It lets you build a rough blockout scene using simple shapes, imported 3D models, or gaussian splats, animate both a camera path and individual objects over time, and then send the rendered video, a start image, and a text prompt straight into downstream AI models such as Seedance, Nano Banana, or Flux. Once you drop the node onto your canvas, it shows a live three.js preview right inside the node, with basic playback controls and a scrub timeline, so you can check your scene without leaving the graph. Clicking Edit opens a fullscreen editor with the complete toolset: adding primitive shapes like cubes and spheres, importing meshes in formats such as GLB, FBX, or OBJ, adding particle emitters, animating objects, sculpting a camera path, and saving the whole thing as a named project. Animation works through keyframes on both the camera and individual objects, each with adjustable easing, and a special waypoint type that bends a smooth curve through a point without pinning it to an exact time. The timeline shows keyframes as diamonds you can click, drag, or multi-select, and a properties panel on the right adapts to whatever is selected, whether that is the whole scene, the camera, or a single object. When you record, the scene is captured and converted into an mp4 using ffmpeg, with framing presets for common aspect ratios like 16:9 or 9:16. Projects are saved on the server per node, including any imported assets, so reopening a ComfyUI workflow restores the full scene exactly as you left it. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Show me how to add the ComfyBlockout node to my ComfyUI canvas and open the fullscreen editor.
Prompt 2
Explain how to keyframe a camera path in ComfyBlockout and connect the video output to Seedance.
Prompt 3
How do particle emitters work in ComfyBlockout and what settings can I adjust?
Prompt 4
Walk me through saving and reopening a ComfyBlockout project.

Frequently asked questions

What is comfyblockout?

A ComfyUI node with a full 3D scene editor for blocking out and animating a shot, then feeding it as video and prompt into AI generators.

What language is comfyblockout written in?

Mainly HTML. The stack also includes HTML, JavaScript, three.js.

What license does comfyblockout use?

The README does not state a license, so terms of use and redistribution are unclear.

How hard is comfyblockout to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is comfyblockout for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.