Nodes/ComfyUI-SplatKit/Sequence Info
ComfyUI Node

Sequence Info

The node that tells you what actually landed on disk

By mickmumpitz·Created about a month ago·Updated 2 days ago· 18
Sequence Info
  • sequence
  • folder
  • frames

Every pipeline has one node that just tells you the truth, and in SplatKit's training half this is it. Wire a sequence into Sequence Info and you get a small block of text in the node: how many frames there are, what quality they were trained at, how many gaussians the last frame ended up with, and the folder they live in. Plus the one sentence that explains where to take the files next.

It's not glamorous. It's the first thing you should queue after training a sequence, because it's the fastest way to tell "this worked" from "this produced something that technically exists."

What it reads

The sequence object carries a meta.json written by the trainer plus lists of files in three folders, and this node formats the interesting parts:

121 frames, quality standard
1842230 gaussians in the last frame
/home/you/ComfyUI/output/my_shot
ply/ holds every frame with full SH (for SuperSplat, Blender, the core's 3D nodes);
splat/ is the compact copy the player streams.

That gaussians in the last frame number is more diagnostic than it looks. A sequence whose counts collapse after frame 40 means the optimiser ran out of signal - usually bad mattes or a camera angle where the subject left frame - and it's the difference between "the whole run is broken" and "one segment is." quality tells you whether you're looking at a draft run you forgot to redo at standard or best, which happens to everyone.

The ply/ vs splat/ distinction in the text is worth internalising. The .ply files are the real output: full spherical harmonics, openable in SuperSplat, Blender, or core ComfyUI nodes through Sequence Frame. splat/ is a compact re-encode the embedded player streams, and it exists purely for playback performance. If you're exporting for another tool, take ply/.

The outputs

folder (STRING) is the sequence's directory - useful for feeding downstream path widgets, or for the Print-to-console habit if you keep losing track of numbered output folders. frames (INT) is the count.

It's also an output node, which means it prints its text into the ComfyUI canvas when the graph runs without you having to wire anything downstream. Drop it in, queue, read.

Installing it

cd ComfyUI/custom_nodes
git clone https://github.com/mickmumpitz/ComfyUI-SplatKit
python_embeded/python.exe -m pip install -r ComfyUI-SplatKit/requirements.txt

Restart, or use ComfyUI Manager and search "ComfyUI-SplatKit". Nothing extra for this node - it reads JSON and lists directories. It doesn't touch the backend environment, and it doesn't render.

When it breaks

  • "Sequence folder does not exist." The path in the graph points at something that's been moved or deleted. Sequences go under ComfyUI/output/, and Train Sequence never overwrites, so a re-run may have landed in a _002 folder rather than the one you're pointing at.
  • A frame count of zero, or an error about no frames. The folder has no ply/ and no splat/. You pointed at the frameset tree (output/splatkit/framesets/...) instead of the sequence tree, or training failed before writing anything.
  • quality ? in the text means there's no meta.json - which happens with a sequence assembled by hand from .ply files, or one written by an external tool. It'll still load and play; you just lose the provenance.
  • Suspicious gaussian count. Compare it against the quality level. best doubles the per-frame refinement of standard, so a big drop in count after switching to best means something else changed too.

The habit worth forming: Sequence Info immediately after Train Sequence, before you spend an hour in the player admiring it. It answers the question you're going to ask anyway, and it answers it in one line of text instead of a folder listing.

CategorySplatKit/Splatting

Inputs (1)

NameTypeDefaultDescription
sequenceSPLATKIT_SEQUENCE

Outputs (2)

NameTypeDescription
folderSTRING
framesINT