Voxel Video Loader

Voxel Video Loader is the unglamorous bookmark of this pack: you point it at a saved voxel-video JSON file and it loads the whole thing back into the graph as a VOXEL_VIDEO. One input, one output, no configuration. It exists so you don't have to rebuild your animation from scratch every time you want to look at it.

How it works

The node takes voxel_video_file (STRING) - a file path - and does exactly one thing: json.load it. The output, voxel_video (VOXEL_VIDEO), is the same dictionary structure that Voxel Blocks Into Voxel Video produces and that Voxel Video Preview renders: Dimensions, Framerate, Block_count, and the Blocks array of frames. It's a load, not a parse - whatever structure is in that file is what comes through the wire.

That's the whole mechanism, and it's why this node is so thin. The heavy lifting happened when the file was written; this node is just the reader.

What to know before you rely on it

• You type the path, there's no file picker. The path is relative to ComfyUI's working directory, so a video saved by the video-maker node lives at something like output/voxel_video_1.json. Wrong path, error. No friendly "file not found" dialog.
• No validation whatsoever. Point it at a non-voxel JSON and it will happily load it and hand the garbage to the next node, which will then fail in a less obvious place. If your preview comes up blank, check that the file is actually a voxel video.
• Watch out for the preview-overwrite problem. The video-maker and the preview node both write files named output/voxel_video_<N>.json, and the preview's counter is broken (it always targets voxel_video_1.json). Run a preview after saving and your saved file may be stomped. Load it back immediately if you care about what's on disk, or keep a separate copy.

Where it fits

Typical flow: Voxel Blocks Into Voxel Video makes the animation, Voxel Video Preview plays it, and if you want to revisit it tomorrow without regenerating every frame, this loader gets you back into the graph in one step - wire its output straight into the preview node. It's the "open saved project" button of the pack.

Installing it

Standard pack install, and this node has essentially zero dependencies beyond Python's json:

# ComfyUI Manager: search "ComfyUI-Voxels", or:
cd ComfyUI/custom_nodes
git clone https://github.com/DanielHabib/ComfyUI-Voxels
# restart ComfyUI

Like the rest of this pack it's a single commit from September 2024 and carries no requirements.txt. Thin, unmaintained, but for its one job - file path in, voxel video out - it's a straightforward and honest node.